CreateDIBPatternBrushPt, fonction (wingdi.h)

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

Voir aussi

BITMAPINFO

Fonctions Brush

Vue d’ensemble des pinceaux

CreateDIBPatternBrush

CreateHatchBrush

CreatePatternBrush

CreateSolidBrush

DeleteObject

GetBrushOrgEx

SelectObject

SetBrushOrgEx