Partager via


CreatePatternBrush, fonction (wingdi.h)

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

Voir aussi

Fonctions Brush

Vue d’ensemble des pinceaux

CreateBitmap

CreateBitmapIndirect

CreateCompatibleBitmap

CreateDIBPatternBrush

CreateDIBPatternBrushPt

CreateDIBSection

CreateHatchBrush

DeleteObject

GetBrushOrgEx

LoadBitmap

SelectObject

SetBrushOrgEx