structure LOGBRUSH32 (wingdi.h)

Article
03/04/2024

La structure LOGBRUSH32 définit le style, la couleur et le motif d’un pinceau physique. Il est similaire à LOGBRUSH, mais il est utilisé pour maintenir la compatibilité entre les plateformes 32 bits et les plateformes 64 bits lorsque nous enregistrons l’enregistrement de métafichier sur une plateforme, puis l’avons lu sur une autre. Ainsi, il est utilisé uniquement dans EMRCREATEBRUSHINDIRECT. Si le code ne se trouve que sur une seule plateforme, LOGBRUSH est suffisant.

Syntaxe

typedef struct tagLOGBRUSH32 {
  UINT     lbStyle;
  COLORREF lbColor;
  ULONG    lbHatch;
} LOGBRUSH32, *PLOGBRUSH32, *NPLOGBRUSH32, *LPLOGBRUSH32;

Membres

lbStyle

Style de pinceau. Le membre lbStyle doit être l’un des styles suivants.

Valeur	Signification
BS_DIBPATTERN	Pinceau de modèle défini par une spécification bitmap indépendante de l’appareil (DIB). Si lbStyle est BS_DIBPATTERN, le membre lbHatch contient un handle pour une DIB empaquetée. Pour plus d’informations, consultez discussion dans lbHatch.
BS_DIBPATTERN8X8	Identique à BS_DIBPATTERN.
BS_DIBPATTERNPT	Pinceau de modèle défini par une spécification bitmap indépendante de l’appareil (DIB). Si lbStyle est BS_DIBPATTERNPT, le membre lbHatch contient un pointeur vers une DIB empaquetée. Pour plus d’informations, consultez discussion dans lbHatch.
BS_HATCHED	Brosse hachurée.
BS_HOLLOW	Pinceau creux.
BS_NULL	Identique à BS_HOLLOW.
BS_PATTERN	Pinceau de modèle défini par une bitmap de mémoire.
BS_PATTERN8X8	Identique à BS_PATTERN.
BS_SOLID	Brosse unie.

lbColor

Couleur dans laquelle le pinceau doit être dessiné. Si lbStyle est le style BS_HOLLOW ou BS_PATTERN, lbColor est ignoré.

Si lbStyle est BS_DIBPATTERN ou BS_DIBPATTERNPT, le mot d’ordre inférieur de lbColor spécifie si les membres bmiColors de la structure BITMAPINFO contiennent des valeurs ou des index rouges, verts, bleus (RVB) explicites dans la palette logique actuellement réalisée. Le membre lbColor doit être l’une des valeurs suivantes.

Valeur	Signification
DIB_PAL_COLORS	La table de couleurs se compose d’un tableau d’index 16 bits dans la palette logique actuellement réalisée.
DIB_RGB_COLORS	La table de couleurs contient des valeurs RVB littérales.

Si lbStyle est BS_HATCHED ou BS_SOLID, lbColor est une valeur de couleur COLORREF . Pour créer une valeur de couleur COLORREF , utilisez la macro RVB .

lbHatch

Style de trappe. La signification dépend du style de pinceau défini par lbStyle.

Si lbStyle est BS_DIBPATTERN, le membre lbHatch contient un handle pour une DIB empaquetée. Pour obtenir ce handle, une application appelle la fonction GlobalAlloc avec GMEM_MOVEABLE (ou LocalAlloc avec LMEM_MOVEABLE) pour allouer un bloc de mémoire, puis remplit la mémoire avec la DIB empaquetée. Une DIB empaquetée se compose d’une structure BITMAPINFO immédiatement suivie du tableau d’octets qui définissent les pixels de l’image bitmap.

Si lbStyle est BS_DIBPATTERNPT, le membre lbHatch contient un pointeur vers une DIB empaquetée. Le pointeur dérive du bloc de mémoire créé par LocalAlloc avec LMEM_FIXED défini ou par GlobalAlloc avec GMEM_FIXED défini, ou il s’agit du pointeur retourné par un appel tel que LocalLock (handle_to_the_dib). Une DIB empaquetée se compose d’une structure BITMAPINFO immédiatement suivie du tableau d’octets qui définissent les pixels de l’image bitmap.

Si lbStyle est BS_HATCHED, le membre lbHatch spécifie l’orientation des lignes utilisées pour créer la trappe. Il peut avoir l’une des valeurs suivantes.

Valeur	Signification
HS_BDIAGONAL	Une trappe de 45 degrés vers le haut, de gauche à droite
HS_CROSS	Hachure horizontale et verticale
HS_DIAGCROSS	45 degrés de hachage croisé
HS_FDIAGONAL	Une trappe de 45 degrés vers le bas, de gauche à droite
HS_HORIZONTAL	Trappe horizontale
HS_VERTICAL	Trappe verticale

Si lbStyle est BS_PATTERN, lbHatch est un handle de la bitmap qui définit le modèle. La bitmap ne peut pas être une bitmap de section DIB, qui est créée par la fonction CreateDIBSection .

Si lbStyle est BS_SOLID ou BS_HOLLOW, lbHatch est ignoré.

Remarques

Bien que lbColor contrôle la couleur de premier plan d’un pinceau à trappe, les fonctions SetBkMode et SetBkColor contrôlent la couleur d’arrière-plan.

Les pinceaux peuvent être créés à partir de bitmaps ou de dibs de plus de 8 x 8 pixels.

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]
En-tête	wingdi.h (inclure Windows.h)