CDC::SetWindowExt

Syntax

CSize SetWindowExt( int x, int y );

CSize SetWindowExt( SIZE size );

Parameters

x

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

y

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

size

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

Remarks

Sets the x- and y-extents of the window associated with the device context. 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.

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.

See Also

CDC::SetViewportExt, ::SetWindowExt, CSize