GetBrushOrgEx, fonction (wingdi.h)

Article
03/06/2024

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