CDC::SetWindowExt

Sets the x- and y-extents of the window associated with the device context.

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

Parameters

  • cx
    Specifies the x-extent (in logical units) of the window.

  • cy
    Specifies the y-extent (in logical units) of the window.

  • size
    Specifies the x- and y-extents (in logical units) of the window.

Return Value

The previous extents of the window (in logical units) as a CSize object. If an error occurs, the x- and y-coordinates of the returned CSize object are both set to 0.

Remarks

The window, along with the device-context viewport, defines how GDI maps points in the logical coordinate system to points in the device coordinate system.

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

  • MM_HIENGLISH

  • MM_HIMETRIC

  • MM_LOENGLISH

  • MM_LOMETRIC

  • MM_TEXT

  • MM_TWIPS

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

Example

See the example for CView::OnPrepareDC.

Requirements

Header: afxwin.h

See Also

Reference

CDC Class

Hierarchy Chart

CDC::GetWindowExt

CDC::SetViewportExt

CSize Class