Freigeben über


CDC::SetViewportOrg

Legt den Viewportursprung des Gerätekontexts fest.

virtual CPoint SetViewportOrg( 
   int x, 
   int y  
); 
CPoint SetViewportOrg( 
   POINT point  
);

Parameter

  • x
    Gibt die X-Koordinate (in den Geräteeinheiten) Rand des Viewports an. Der Wert muss innerhalb des Bereichs des Gerätekoordinatensystems sein.

  • y
    Gibt die y-Koordinate (in den Geräteeinheiten) Rand des Viewports an. Der Wert muss innerhalb des Bereichs des Gerätekoordinatensystems sein.

  • point
    Gibt den Ursprung des Viewports an. Die Werte müssen innerhalb des Bereichs des Gerätekoordinatensystems sein. Sie können eine POINT-Struktur oder ein CPoint-Objekt für diesen Parameter übergeben.

Rückgabewert

Der vorherige Ursprung des Viewports (in Gerätekoordinaten) als CPoint-Objekt.

Hinweise

Der Viewport, zusammen mit dem Gerätekontextfenster, definiert, wie GDI Punkte im System der logischen Koordinatensystem in Punkte im Koordinatensystem des aktuellen Gerätes zuordnet. Das heißt, sie definieren, wie GDI logischen Koordinaten in Gerätekoordinaten konvertiert.

Der Viewportursprung markiert den Punkt im Gerätekoordinatensystem, dem GDI den Fensterursprung zuordnet, ein Punkt im System der logischen Koordinatensystem, das von der SetWindowOrg-Memberfunktion angegeben wird. GDI ordnet alle anderen Punkte zu, indem dem gleichen Prozess folgt, der erforderlich ist, um den Fensterursprung zum Viewportursprung zuzuordnen. Beispielsweise sind alle Punkte in einem Kreis um den Punkt am Fensterursprung in einem Kreis um den Punkt am Viewportursprung. Ebenso sind alle Punkte in einer Zeile, die durch den Fensterursprung übergeben wird, in einer Zeile, die durch den Viewportursprung führt.

Beispiel

Im Beispiel für CView::OnPrepareDC.

Anforderungen

Header: afxwin.h

Siehe auch

Referenz

CDC-Klasse

Hierarchiediagramm

CDC::SetWindowOrg

CPoint Class

POINT-Struktur

CDC::GetViewportOrg