Freigeben über


SetViewportOrgEx-Funktion (wingdi.h)

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

Weitere Informationen

Koordinatenraum und Transformationsfunktionen

Übersicht über Koordinatenräume und Transformationen

GetViewportOrgEx

PUNKT

SetWindowOrgEx