CreateCompatibleBitmap, fonction (wingdi.h)

Article
03/13/2024

La fonction CreateCompatibleBitmap crée une bitmap compatible avec l’appareil associé au contexte d’appareil spécifié.

Syntaxe

HBITMAP CreateCompatibleBitmap(
  [in] HDC hdc,
  [in] int cx,
  [in] int cy
);

Paramètres

[in] hdc

Handle d'un contexte de périphérique.

[in] cx

Largeur de bitmap, en pixels.

[in] cy

Hauteur de bitmap, en pixels.

Valeur retournée

Si la fonction réussit, la valeur de retour est un handle pour la bitmap compatible (DDB).

Si la fonction échoue, la valeur de retour est NULL.

Remarques

Le format de couleur de la bitmap créée par la fonction CreateCompatibleBitmap correspond au format de couleur de l’appareil identifié par le paramètre hdc . Cette bitmap peut être sélectionnée dans n’importe quel contexte de périphérique mémoire compatible avec l’appareil d’origine.

Étant donné que les contextes de périphérique mémoire autorisent les bitmaps de couleur et monochromes, le format de la bitmap retourné par la fonction CreateCompatibleBitmap diffère lorsque le contexte d’appareil spécifié est un contexte de périphérique mémoire. Toutefois, une bitmap compatible qui a été créée pour un contexte d’appareil nonmory possède toujours le même format de couleur et utilise la même palette de couleurs que le contexte d’appareil spécifié.

Remarque : Lorsqu’un contexte de périphérique mémoire est créé, une bitmap monochrome 1 par 1 est initialement sélectionnée. Si ce contexte de périphérique de mémoire est utilisé dans CreateCompatibleBitmap, la bitmap créée est une bitmap monochrome . Pour créer une bitmap de couleur, utilisez le HDC utilisé pour créer le contexte de périphérique de mémoire, comme indiqué dans le code suivant :


    HDC memDC = CreateCompatibleDC ( hDC );
    HBITMAP memBM = CreateCompatibleBitmap ( hDC, nWidth, nHeight );
    SelectObject ( memDC, memBM );

Si une application définit les paramètres nWidth ou nHeight sur zéro, CreateCompatibleBitmap retourne le handle à une bitmap monochrome de 1 pixel par 1.

Si une section DIB, qui est une bitmap créée par la fonction CreateDIBSection , est sélectionnée dans le contexte de l’appareil identifié par le paramètre hdc , CreateCompatibleBitmap crée une section DIB.

Lorsque vous n’avez plus besoin de la bitmap, appelez la fonction DeleteObject pour la supprimer.

Exemples

Pour obtenir un exemple, consultez Mise à l’échelle d’une image.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows 2000 Professionnel [applications de bureau uniquement]
Serveur minimal pris en charge	Windows 2000 Server [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	wingdi.h (inclure Windows.h)
Bibliothèque	Gdi32.lib
DLL	Gdi32.dll