SetBrushOrgEx, fonction (wingdi.h)
La fonction SetBrushOrgEx définit l’origine du pinceau que GDI affecte au pinceau suivant qu’une application sélectionne dans le contexte d’appareil spécifié.
Syntaxe
BOOL SetBrushOrgEx(
[in] HDC hdc,
[in] int x,
[in] int y,
[out] LPPOINT lppt
);
Paramètres
[in] hdc
Handle pour le contexte de l’appareil.
[in] x
Coordonnée x, en unités d’appareil, de la nouvelle origine du pinceau. Si cette valeur est supérieure à la largeur du pinceau, sa valeur est réduite à l’aide de l’opérateur de module (nXOrgmod brush width).
[in] y
Coordonnée y, en unités d’appareil, de la nouvelle origine du pinceau. Si cette valeur est supérieure à la hauteur du pinceau, sa valeur est réduite à l’aide de l’opérateur de module (nYOrgmod brush height).
[out] lppt
Pointeur vers une structure POINT qui reçoit l’origine du pinceau précédent.
Ce paramètre peut être NULL si l’origine du pinceau précédent n’est pas requise.
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 une paire de coordonnées 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 de pixels la plus à gauche ; la largeur correspond à la colonne la plus à droite. Pour les coordonnées verticales, la valeur 0 correspond à la ligne supérieure de pixels ; la hauteur correspond à la ligne la plus basse.
Le système suit automatiquement l’origine de tous les contextes d’appareil gérés par la fenêtre et ajuste leurs pinceaux en fonction des besoins pour maintenir un alignement des modèles sur la surface. L’origine du pinceau définie avec cet appel est relative à l’angle supérieur gauche de la zone cliente.
Une application doit appeler SetBrushOrgEx après avoir défini le mode d’étirement bitmap sur HALFTONE à l’aide de SetStretchBltMode. Cela doit être fait pour éviter un mauvais alignement des pinceaux.
Le système suit automatiquement l’origine de tous les contextes d’appareil gérés par la fenêtre et ajuste leurs pinceaux en fonction des besoins pour maintenir un alignement des modèles sur la surface.
Configuration requise
| 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 |