SetViewportExtEx-Funktion (wingdi.h)

Artikel
08/27/2023

Die SetViewportExtExtEx-Funktion legt die horizontalen und vertikalen Blöcke des Viewports für einen Gerätekontext unter Verwendung der angegebenen Werte fest.

Syntax

BOOL SetViewportExtEx(
  [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 Viewports in Geräteeinheiten.

[in] y

Die vertikale Ausdehnung des Viewports in Geräteeinheiten.

[out] lpsz

Ein Zeiger auf eine SIZE-Struktur , die die vorherigen Viewportausdehnungen in Geräteeinheiten 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

Der Viewport bezieht sich auf das Gerätekoordinatensystem des Geräteraums. Der Umfang ist der maximale Wert einer Achse. Diese Funktion legt die maximalen Werte für die horizontale und vertikale Achse des Viewports in Gerätekoordinaten (oder Pixel) fest. Bei der Zuordnung zwischen Seiten- und Gerätebereich bestimmen SetWindowExtEx undSetViewportExtExtEx 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 die SetWindowExtExtEx-Funktion aufrufen, bevor sie SetViewportExtEx aufruft. 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


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