SetBrushOrgEx, fonction (wingdi.h)

Article
03/08/2023

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.

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