Partager via


CBitmap::CreateBitmap

Initialise une bitmap en mémoire du périphérique qui a une largeur, la hauteur, et le modèle binaire spécifiés.

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

Paramètres

  • nWidth
    Spécifie la largeur (en pixels) de la bitmap.

  • nHeight
    Spécifie la hauteur (en pixels) de la bitmap.

  • nPlanes
    Indique le nombre de avions de couleur dans la bitmap.

  • nBitcount
    Spécifie le nombre de bits par pixel de couleur d'affichage.

  • lpBits
    Indique un tableau d'octets qui contient les valeurs de bits de la bitmap initiales. Si c'est null, la nouvelle bitmap est laissée non initialisée.

Valeur de retour

Une valeur différente de zéro si l'opération a réussi ; sinon 0.

Notes

Pour une bitmap de couleur, nPlanes ou le paramètre d' nBitcount doit avoir la valeur 1. Si les deux paramètres sont placés à 1, CreateBitmap crée une image bitmap de monochrome.

Bien qu'une bitmap ne peut pas être directement sélectionnée pour un périphérique d'affichage, elle peut être sélectionnée comme bitmap actuelle pour un « contexte de périphérique » à l'aide de CDC::SelectObject et être copiée dans n'importe quel contexte compatible de périphérique à l'aide de la fonction d' CDC::BitBlt .

Lorsque vous avez fini d'utiliser l'objet d' CBitmap créé par la fonction d' CreateBitmap, d'abord sélectionnez l'image bitmap en dehors de le contexte de périphérique, puis supprimez l'objet d' CBitmap .

Pour plus d'informations, consultez la description du champ de bmBits dans la structure de BITMAP . La structure d' BITMAP est décrite dans la fonction membre d' CBitmap::CreateBitmapIndirect .

Configuration requise

En-tête : afxwin.h

Voir aussi

Référence

CBitmap, classe

Graphique de la hiérarchie

CDC::SelectObject

CGdiObject::DeleteObject

CDC::BitBlt

CreateBitmap