SetWindowExtEx-Funktion (wingdi.h)

Artikel
03/04/2024

Die SetWindowExtEx-Funktion legt die horizontalen und vertikalen Blöcke des Fensters für einen Gerätekontext mithilfe der angegebenen Werte fest.

Syntax

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

Parameter

[in] hdc

Ein Handle für den Gerätekontext.

[in] x

Die horizontale Ausdehnung des Fensters in logischen Einheiten.

[in] y

Die vertikale Ausdehnung des Fensters in logischen Einheiten.

[out] lpsz

Ein Zeiger auf eine SIZE-Struktur , die die vorherigen Fensterausdehnungen in logischen Einheiten empfängt. Wenn lpSizeNULL ist, wird dieser Parameter nicht verwendet.

Rückgabewert

Wenn die Funktion erfolgreich ist, ist der Rückgabewert ungleich Null.

Wenn die Funktion fehlerhaft ist, ist der Rückgabewert null.

Hinweise

Das Fenster bezieht sich auf das logische Koordinatensystem des Seitenraums. Der Umfang ist der maximale Wert einer Achse. Diese Funktion legt die Maximalwerte für die horizontale und vertikale Achse des Fensters (in logischen Koordinaten) fest. Bei der Zuordnung zwischen Seiten- und Gerätebereich bestimmen SetViewportExtExtEx und SetWindowExtEx den Skalierungsfaktor zwischen dem Fenster und dem Viewport. Weitere Informationen finden Sie unter Transformation von Koordinatenräumen.

Wenn die folgenden Zuordnungsmodi festgelegt sind, werden Aufrufe der Funktionen SetWindowExtEx und SetViewportExtEx ignoriert:

MM_HIENGLISH
MM_HIMETRIC
MM_LOENGLISH
MM_LOMETRIC
MM_TEXT
MM_TWIPS

Wenn MM_ISOTROPIC Modus festgelegt ist, muss eine Anwendung vor dem Aufrufen von SetViewportExtExtEx dieSetWindowExtExtEx-Funktion aufrufen. Beachten Sie, dass für den MM_ISOTROPIC-Modus bestimmte Teile eines Nichtquare-Bildschirms möglicherweise nicht für die Anzeige verfügbar sind, da die logischen Einheiten auf beiden Achsen die gleichen physischen Abstände darstellen.

Beispiele

Ein Beispiel finden Sie unter Ungültiges Aufheben des Clientbereichs.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows 2000 Server [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	wingdi.h (windows.h einschließen)
Bibliothek	Gdi32.lib
DLL	Gdi32.dll