SetWindowOrgEx-Funktion (wingdi.h)

Artikel
03/13/2024

Die SetWindowOrgEx-Funktion gibt an, welcher Fensterpunkt dem Viewportursprung (0,0) zugeordnet ist.

Syntax

BOOL SetWindowOrgEx(
  [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 logischen Einheiten des neuen Fensterursprungs.

[in] y

Die y-Koordinate in logischen Einheiten des neuen Fensterursprungs.

[out] lppt

Ein Zeiger auf eine POINT-Struktur , die den vorherigen Ursprung des Fensters in logischen Einheiten 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

Dadurch wird die Zuordnung vom logischen Koordinatenraum (auch als Fenster bezeichnet) zum Gerätekoordinatenbereich ( viewport) definiert. SetWindowOrgEx gibt an, welcher logische Punkt dem Gerätepunkt (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 (xWinOrg, yWinOrg) to the device point (0,0) 
SetWindowOrgEx (hdc, xWinOrg, yWinOrg, NULL)

Dies bezieht sich auf die SetViewportOrgEx-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.

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