Partager via


CreateCompatibleBitmap, fonction (wingdi.h)

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

Voir aussi

Fonctions bitmap

Vue d’ensemble des bitmaps

CreateDIBSection

DeleteObject

SelectObject