SetViewportEx, fonction (wingdi.h)

Article
03/08/2023

La fonction SetViewportExtEx définit les étendues horizontales et verticales de la fenêtre d’affichage pour un contexte d’appareil à l’aide des valeurs spécifiées.

Syntaxe

BOOL SetViewportExtEx(
  [in]  HDC    hdc,
  [in]  int    x,
  [in]  int    y,
  [out] LPSIZE lpsz
);

Paramètres

[in] hdc

Handle pour le contexte de l’appareil.

[in] x

Étendue horizontale, en unités d’appareil, de la fenêtre d’affichage.

[in] y

Étendue verticale, en unités d’appareil, de la fenêtre d’affichage.

[out] lpsz

Pointeur vers une structure SIZE qui reçoit les extensions de fenêtre d’affichage précédentes, dans les unités d’appareil. Si lpSize 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

La fenêtre d’affichage fait référence au système de coordonnées de l’appareil de l’espace de l’appareil. L’étendue est la valeur maximale d’un axe. Cette fonction définit les valeurs maximales pour les axes horizontaux et verticaux de la fenêtre d’affichage en coordonnées d’appareil (ou pixels). Lors du mappage entre l’espace de page et l’espace appareil, SetWindowExtEx et SetViewportExtEx déterminent le facteur de mise à l’échelle entre la fenêtre et la fenêtre d’affichage. Pour plus d’informations, consultez Transformation des espaces de coordonnées.

Lorsque les modes de mappage suivants sont définis, les appels aux fonctions SetWindowExtEx et SetViewportExtEx sont ignorés.

MM_HIENGLISH
MM_HIMETRIC
MM_LOENGLISH
MM_LOMETRIC
MM_TEXT
MM_TWIPS

Lorsque MM_ISOTROPIC mode est défini, une application doit appeler la fonction SetWindowExtEx avant d’appeler SetViewportExtEx. Notez que pour le mode MM_ISOTROPIC certaines parties d’un écran non carré peuvent ne pas être disponibles pour l’affichage, car les unités logiques sur les deux axes représentent des distances physiques égales.

Exemples

Pour obtenir un exemple, consultez Invalidating the Client Area.

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