SetViewportOrgEx, fonction (wingdi.h)

Article
08/27/2023

La fonction SetViewportOrgEx spécifie le point d’appareil mappé à l’origine de la fenêtre (0,0).

Syntaxe

BOOL SetViewportOrgEx(
  [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 de la fenêtre d’affichage.

[in] y

Coordonnée y, en unités d’appareil, de la nouvelle origine de la fenêtre d’affichage.

[out] lppt

Pointeur vers une structure POINT qui reçoit l’origine de la fenêtre d’affichage précédente, en coordonnées d’appareil. Si lpPoint a la valeur NULL, ce paramètre n’est pas utilisé.

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

Cette fonction (avec SetViewportExtEx et SetWindowExtEx) permet de définir le mappage de l’espace de coordonnées logique (également appelé fenêtre) à l’espace de coordonnées de l’appareil (la fenêtre d’affichage). SetViewportOrgEx spécifie le point d’appareil mappé au point logique (0,0). Elle a pour effet de décaler les axes de sorte que le point logique (0,0) ne fait plus référence au coin supérieur gauche.


//map the logical point (0,0) to the device point (xViewOrg, yViewOrg) 
SetViewportOrgEx ( hdc, xViewOrg, yViewOrg, NULL)

Cela est lié à la fonction SetWindowOrgEx . En règle générale, vous utiliserez une fonction ou l’autre, mais pas les deux. Quelle que soit votre utilisation de SetWindowOrgEx et SetViewportOrgEx, le point d’appareil (0,0) est toujours le coin supérieur gauche.

Exemples

Pour obtenir un exemple, consultez Redessiner dans la région de mise à jour.

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