Partager via


SetViewportEx, fonction (wingdi.h)

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

Voir aussi

Fonctions d’espace de coordonnées et de transformation

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

GetViewportExtEx

SIZE

SetWindowExtEx