CreateBitmap, fonction (wingdi.h)
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 |
|---|---|
|
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 |