CBitmap::CreateBitmap

Inizializza una bitmap dipendente dal dispositivo di memoria con larghezza, altezza e lo schema di bit specificati.

BOOL CreateBitmap(
   int nWidth,
   int nHeight,
   UINT nPlanes,
   UINT nBitcount,
   const void* lpBits 
);

Parametri

  • nWidth
    Specifica la larghezza (in pixel) della bitmap.

  • nHeight
    Specifica l'altezza in pixel della bitmap.

  • nPlanes
    Specifica il numero di aerei di colore nella bitmap.

  • nBitcount
    Specifica il numero di bit di colore per pixel visualizzato.

  • lpBits
    Punta a una matrice di byte contenente i valori di bit della bitmap iniziali.Se è NULL, la nuova bitmap viene lasciata non inizializzate.

Valore restituito

Diverso da zero se ha esito positivo; in caso contrario 0.

Note

Per una bitmap di colore, nPlanes o il parametro di nBitcount deve essere impostato su 1.Se entrambi parametri vengono impostati su 1, CreateBitmap crea una bitmap monocromatica.

Sebbene una bitmap non è direttamente essere selezionata per uno schermo, può essere selezionata come la bitmap corrente per un "contesto di dispositivo di archiviazione" tramite CDC::SelectObject e copiati al contesto di dispositivo compatibile con la funzione di CDC::BitBlt.

Dopo aver utilizzato l'oggetto di CBitmap creato dalla funzione di CreateBitmap, è necessario innanzitutto selezionare la bitmap dal contesto di dispositivo, quindi eliminare l'oggetto di CBitmap.

Per ulteriori informazioni, vedere la descrizione del campo bmBits nella struttura bitmap.La struttura di BITMAP contenuta nella funzione membro di CBitmap::CreateBitmapIndirect.

Requisiti

Header: afxwin.h

Vedere anche

Riferimenti

Classe di CBitmap

Grafico della gerarchia

CDC::SelectObject

CGdiObject::DeleteObject

CDC::BitBlt

CreateBitmap