Partager via


SetWindowExtEx, fonction (wingdi.h)

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

Syntaxe

BOOL SetWindowExtEx(
  [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 de la fenêtre en unités logiques.

[in] y

Étendue verticale de la fenêtre en unités logiques.

[out] lpsz

Pointeur vers une structure SIZE qui reçoit les extensions de fenêtre précédentes, en unités logiques. 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 fait référence au système de coordonnées logique de l’espace de page. 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 (en coordonnées logiques). Lors du mappage entre l’espace de page et l’espace appareil, SetViewportExtEx et SetWindowExtEx 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

Condition requise Valeur
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

GetWindowExtEx

SIZE

SetViewportExtEx