SetViewportOrgEx-Funktion (wingdi.h)

Artikel
08/27/2023

Die SetViewportOrgEx-Funktion gibt an, welcher Gerätepunkt dem Fensterursprung (0,0) zugeordnet ist.

Syntax

BOOL SetViewportOrgEx(
  [in]  HDC     hdc,
  [in]  int     x,
  [in]  int     y,
  [out] LPPOINT lppt
);

Parameter

[in] hdc

Ein Handle für den Gerätekontext.

[in] x

Die x-Koordinate in Geräteeinheiten des neuen Viewportursprungs.

[in] y

Die y-Koordinate in Geräteeinheiten des neuen Viewportursprungs.

[out] lppt

Ein Zeiger auf eine POINT-Struktur , die den vorherigen Viewportursprung in Gerätekoordinaten empfängt. Wenn lpPointNULL 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

Diese Funktion (zusammen mit SetViewportExtExtEx und SetWindowExtExtEx) hilft beim Definieren der Zuordnung vom logischen Koordinatenraum (auch als Fenster bezeichnet) zum Gerätekoordinatenbereich ( viewport). SetViewportOrgEx gibt an, welcher Gerätepunkt dem logischen Punkt (0,0) zugeordnet ist. Es hat den Effekt, dass die Achsen so verschoben werden, dass der logische Punkt (0,0) nicht mehr auf die obere linke Ecke verweist.


//map the logical point (0,0) to the device point (xViewOrg, yViewOrg) 
SetViewportOrgEx ( hdc, xViewOrg, yViewOrg, NULL)

Dies bezieht sich auf die SetWindowOrgEx-Funktion . Im Allgemeinen verwenden Sie die eine oder die andere Funktion, aber nicht beide. Unabhängig von Der Verwendung von SetWindowOrgEx und SetViewportOrgEx ist der Gerätepunkt (0,0) immer die obere linke Ecke.

Beispiele

Ein Beispiel finden Sie unter Neuzeichnung im Updatebereich.

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