SetWindowExtEx, fonction (wingdi.h)

Article
03/13/2024

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