CreatePatternBrush, fonction (wingdi.h)

Article
03/06/2024

La fonction CreatePatternBrush crée un pinceau logique avec le modèle bitmap spécifié. La bitmap peut être une bitmap de section DIB, qui est créée par la fonction CreateDIBSection , ou il peut s’agir d’une bitmap dépendante de l’appareil.

Syntaxe

HBRUSH CreatePatternBrush(
  [in] HBITMAP hbm
);

Paramètres

[in] hbm

Handle de la bitmap à utiliser pour créer le pinceau logique.

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 de motif 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 CreatePatternBrush, elle peut sélectionner ce pinceau dans n’importe quel contexte d’appareil en appelant la fonction SelectObject .

Vous pouvez supprimer un pinceau de modèle sans affecter la bitmap associée à l’aide de la fonction DeleteObject . Par conséquent, vous pouvez ensuite utiliser cette bitmap pour créer n’importe quel nombre de pinceaux de modèle.

Un pinceau créé à l’aide d’une bitmap monochrome (1 bit par pixel) contient le texte et les couleurs d’arrière-plan du contexte d’appareil dans lequel il est dessiné. Les pixels représentés par un 0 bit sont dessinés avec la couleur du texte actuel ; les pixels représentés par un 1 bit sont dessinés avec la couleur d’arrière-plan actuelle.

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.

Exemples

Pour obtenir un exemple, consultez Utilisation de pinceaux.

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