Freigeben über


CDC::SetViewportExt

Legt das die X- und y-Wertebereiche des Viewports des Gerätekontexts fest.

virtual CSize SetViewportExt( 
   int cx, 
   int cy  
); 
CSize SetViewportExt( 
   SIZE size  
);

Parameter

  • cx
    Gibt den XWertebereich des Viewports an (in den Geräteeinheiten).

  • cy
    Gibt den y-Wertebereich des Viewports an (in den Geräteeinheiten).

  • size
    Gibt das die X- und y-Wertebereiche des Viewports an (in den Geräteeinheiten).

Rückgabewert

Der vorherige Extent des Viewports als CSize-Objekte ein. Wenn ein Fehler auftritt, sind die x- und y-Koordinaten des zurückgegebenen Objekts CSize beide auf 0.

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.

Wenn die folgenden Zuordnungsmodi festgelegt werden, werden Aufrufe SetWindowExt und SetViewportExt ignoriert:

MM_HIENGLISH

MM_LOMETRIC

MM_HIMETRIC

MM_TEXT

MM_LOENGLISH

MM_TWIPS

Wenn MM_ISOTROPIC Modus festgelegt wird, muss eine Anwendung die SetWindowExt-Memberfunktion aufrufen, bevor sie SetViewportExt aufruft.

Beispiel

Im Beispiel für CView::OnPrepareDC.

Anforderungen

Header: afxwin.h

Siehe auch

Referenz

CDC-Klasse

Hierarchiediagramm

CDC::SetWindowExt

CSize Class

CDC::GetViewportExt