CreateDIBPatternBrush, fonction (wingdi.h)

Article
03/04/2024

La fonction CreateDIBPatternBrush crée un pinceau logique dont le modèle est spécifié par la bitmap indépendante de l’appareil (DIB) spécifiée. Le pinceau peut ensuite être sélectionné dans n’importe quel contexte d’appareil associé à un appareil prenant en charge les opérations raster.

Note Cette fonction est fournie uniquement pour la compatibilité avec les versions 16 bits de Windows. Les applications doivent utiliser la fonction CreateDIBPatternBrushPt .

Syntaxe

HBRUSH CreateDIBPatternBrush(
  [in] HGLOBAL h,
  [in] UINT    iUsage
);

Paramètres

[in] h

Handle vers un objet de mémoire globale contenant une DIB empaquetée, qui se compose d’une structure BITMAPINFO immédiatement suivie d’un tableau d’octets définissant les pixels de la bitmap.

[in] iUsage

Spécifie si le membre bmiColors de la structure BITMAPINFO est initialisé et, le cas échéant, si ce membre contient des valeurs ou des index rouges, verts, bleus (RVB) explicites dans une palette logique. Le paramètre fuColorSpec doit être l’une des valeurs suivantes.

Valeur	Signification
DIB_PAL_COLORS	Une table de couleurs est fournie et se compose d’un tableau d’index 16 bits dans la palette logique du contexte d’appareil dans lequel le pinceau doit être sélectionné.
DIB_RGB_COLORS	Une table de couleurs est fournie et contient des valeurs RVB littérales.

Valeur retournée

Si la fonction réussit, la valeur de retour identifie un pinceau logique.

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

Remarques

Lorsqu’une application sélectionne un pinceau de modèle DIB bicolore dans un contexte d’appareil monochrome, le système ne reconnaît pas les couleurs spécifiées dans la DIB ; au lieu de cela, il affiche le pinceau de modèle à l’aide des couleurs d’arrière-plan et de premier plan actuelles du contexte de l’appareil. Les pixels mappés à la première couleur de la DIB (décalage 0 dans la table de couleurs DIB) sont affichés à l’aide de la couleur de premier plan ; Les pixels mappés à la deuxième couleur (décalage 1 dans la table de couleurs) sont affichés à l’aide de la couleur d’arrière-plan.

Lorsque vous n’avez plus besoin du pinceau, appelez la fonction DeleteObject pour le supprimer.

ICM: Aucune couleur n’est effectuée lors de la création du pinceau. Toutefois, la gestion des couleurs est effectuée lorsque le pinceau est sélectionné dans un contexte d’appareil avec ICM.

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