CreateBitmap, fonction (wingdi.h)

Article
03/08/2023

La fonction CreateBitmap crée une bitmap avec la largeur, la hauteur et le format de couleur spécifiés (plans de couleurs et bits par pixel).

Syntaxe

HBITMAP CreateBitmap(
  [in] int        nWidth,
  [in] int        nHeight,
  [in] UINT       nPlanes,
  [in] UINT       nBitCount,
  [in] const VOID *lpBits
);

Paramètres

[in] nWidth

Largeur de bitmap, en pixels.

[in] nHeight

Hauteur de bitmap, en pixels.

[in] nPlanes

Nombre de plans de couleurs utilisés par l’appareil.

[in] nBitCount

Nombre de bits requis pour identifier la couleur d’un seul pixel.

[in] lpBits

Pointeur vers un tableau de données de couleur utilisé pour définir les couleurs dans un rectangle de pixels. Chaque ligne d’analyse du rectangle doit être alignée sur les mots (les lignes d’analyse qui ne sont pas alignées doivent être rembourrées avec des zéros). La taille de mémoire tampon attendue, cj, peut être calculée à l’aide de la formule :

cj = (((nWidth * nPlanes * nBitCount + 15) >> 4) << 1) * nHeight;

Si ce paramètre a la valeur NULL, le contenu de la nouvelle bitmap n’est pas défini.

Valeur retournée

Si la fonction réussit, la valeur de retour est un handle pour une bitmap.

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

Cette fonction peut retourner la valeur suivante.

Code de retour	Description
ERROR_INVALID_BITMAP	La taille calculée de la bitmap est inférieure à zéro.

Remarques

La fonction CreateBitmap crée une bitmap dépendante de l’appareil.

Une fois qu’une bitmap est créée, elle peut être sélectionnée dans un contexte d’appareil en appelant la fonction SelectObject . Toutefois, la bitmap ne peut être sélectionnée dans un contexte d’appareil que si la bitmap et le contrôleur de domaine ont le même format.

La fonction CreateBitmap peut être utilisée pour créer des bitmaps de couleur. Toutefois, pour des raisons de performances, les applications doivent utiliser CreateBitmap pour créer des bitmaps monochromes et CreateCompatibleBitmap pour créer des bitmaps de couleur. Chaque fois qu’une image bitmap de couleur retournée à partir de CreateBitmap est sélectionnée dans un contexte d’appareil, le système vérifie que l’image bitmap correspond au format du contexte d’appareil dans lequel elle est sélectionnée. Étant donné que CreateCompatibleBitmap prend un contexte d’appareil, il retourne une bitmap qui a le même format que le contexte d’appareil spécifié. Ainsi, les appels suivants à SelectObject sont plus rapides avec une bitmap de couleur à partir de CreateCompatibleBitmap qu’avec une bitmap de couleur retournée à partir de CreateBitmap.

Si l’image bitmap est monochrome, les zéros représentent la couleur de premier plan et les autres représentent la couleur d’arrière-plan du contexte de l’appareil de destination.

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

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

Configuration requise


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