Partager via


CBitmap::CreateCompatibleBitmap

Initialise une bitmap qui est compatible avec l'appareil spécifié par pDC.

BOOL CreateCompatibleBitmap( 
   CDC* pDC, 
   int nWidth, 
   int nHeight  
);

Paramètres

  • pDC
    Spécifie le contexte de périphérique.

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

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

Valeur de retour

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

Notes

La bitmap a le même nombre de avions de couleur ou le même format de bits par pixel que le contexte spécifié de périphérique. Elle peut être sélectionnée comme bitmap actuelle pour tout appareil mémoire qui est compatible avec celui spécifié par pDC.

Si pDC est un contexte de périphérique, la bitmap retourné a le même format que la bitmap sélectionnée dans ce contexte de périphérique. Un « contexte de périphérique » est un bloc de mémoire qui représente une surface d'affichage. Il peut être utilisé pour préparations image dans la mémoire avant de les copier à la surface d'affichage réelle du périphérique compatible.

Lorsqu'un contexte de périphérique est créé, GDI sélectionne automatiquement une bitmap monochrome d'actions pour celui-ci.

Étant donné qu'un contexte de périphérique de couleur peut avoir des bitmaps de couleur ou de monochrome sélectionnées, le format de la bitmap retournée par la fonction d' CreateCompatibleBitmap n'est pas toujours identiques ; toutefois, le format d'une bitmap compatible pour un contexte non mémoire de périphérique est toujours dans le format du périphérique.

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

Configuration requise

Header: afxwin.h

Voir aussi

Référence

CBitmap, classe

Graphique de la hiérarchie

CreateCompatibleBitmap

CGdiObject::DeleteObject