Partager via


SetViewportOrgEx, fonction (wingdi.h)

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

Voir aussi

Fonctions d’espace de coordonnées et de transformation

Vue d’ensemble des espaces et transformations de coordonnées

GetViewportOrgEx

POINT

SetWindowOrgEx