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 |