CDC::SetViewportExt

Sets the x- and y-extents of the viewport of the device context.

Syntax

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

Parameters

• cx
  Specifies the x-extent of the viewport (in device units).

• cy
  Specifies the y-extent of the viewport (in device units).

• size
  Specifies the x- and y-extents of the viewport (in device units).

Return Value

The previous extents of the viewport as a CSize object. When an error occurs, the x- and y-coordinates of the returned CSize object are both set to 0.

Remarks

The viewport, along with the device-context window, defines how GDI maps points in the logical coordinate system to points in the coordinate system of the actual device. In other words, they define how GDI converts logical coordinates into device coordinates.

When the following mapping modes are set, calls to SetWindowExt and SetViewportExt are ignored:

When MM_ISOTROPIC mode is set, an application must call the SetWindowExt member function before it calls SetViewportExt.

Example

See the example for CView::OnPrepareDC.

Requirements

Header: afxwin.h

See Also

CDC Class
Hierarchy Chart
CDC::SetWindowExt
CSize Class
CDC::GetViewportExt