GetBrushOrgEx, fonction (wingdi.h)
La fonction GetBrushOrgEx récupère l’origine actuelle du pinceau pour le contexte d’appareil spécifié. Cette fonction remplace la fonction GetBrushOrg .
Syntaxe
BOOL GetBrushOrgEx(
[in] HDC hdc,
[out] LPPOINT lppt
);
Paramètres
[in] hdc
Handle dans le contexte de l’appareil.
[out] lppt
Pointeur vers une structure POINT qui reçoit l’origine du pinceau, dans les coordonnées de l’appareil.
Valeur retournée
Si la fonction réussit, la valeur de retour est différente de zéro.
Si la fonction échoue, la valeur de retour est égale à zéro.
Remarques
Un pinceau est une bitmap que le système utilise pour peindre les intérieurs des formes remplies.
L’origine du pinceau est un ensemble de coordonnées avec des valeurs comprises entre 0 et 7, spécifiant l’emplacement d’un pixel dans la bitmap. Les coordonnées d’origine du pinceau par défaut sont (0,0). Pour les coordonnées horizontales, la valeur 0 correspond à la colonne la plus à gauche des pixels ; la valeur 7 correspond à la colonne la plus à droite. Pour les coordonnées verticales, la valeur 0 correspond à la ligne supérieure de pixels ; la valeur 7 correspond à la ligne la plus basse. Lorsque le système positionne le pinceau au début d’une opération de peinture, il mappe l’origine du pinceau à l’emplacement dans la zone cliente de la fenêtre spécifiée par l’origine du pinceau. Par exemple, si l’origine est définie sur (2,3), le système mappe l’origine du pinceau (0,0) à l’emplacement (2,3) sur la zone cliente de la fenêtre.
Si une application utilise un pinceau pour remplir les arrière-plans d’une fenêtre parente et d’une fenêtre enfant avec des couleurs correspondantes, il peut être nécessaire de définir l’origine du pinceau après avoir peint la fenêtre parente, mais avant de peindre la fenêtre enfant.
Le système suit automatiquement l’origine de tous les contextes d’appareils gérés par la fenêtre et ajuste leurs pinceaux si nécessaire pour maintenir un alignement des modèles sur la surface.
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 |