CreateDIBPatternBrushPt, fonction (wingdi.h)

Article
03/04/2024

La fonction CreateDIBPatternBrushPt crée un pinceau logique dont le modèle est spécifié par la bitmap indépendante du périphérique (DIB).

Syntaxe

HBRUSH CreateDIBPatternBrushPt(
  [in] const VOID *lpPackedDIB,
  [in] UINT       iUsage
);

Paramètres

[in] lpPackedDIB

Pointeur vers une DIB packed composée 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 contient une table de couleurs valide et, le cas échéant, si les entrées de cette table de couleurs contiennent des valeurs ou des index de palette (RVB) explicites. Le paramètre iUsage 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

Un pinceau est une bitmap que le système utilise pour peindre les intérieurs des formes remplies.

Une fois qu’une application a créé un pinceau en appelant CreateDIBPatternBrushPt, elle peut sélectionner ce pinceau dans n’importe quel contexte d’appareil en appelant la fonction SelectObject .

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