SetViewportExtEx  H69_9F 

The SetViewportExtEx function sets the horizontal and vertical extents of the viewport for a device context by using the specified values.

BOOL SetViewportExtEx(

    HDC hdc,

// handle of device context

    int nXExtent,

// new horizontal viewport extent 

    int nYExtent,

// new vertical viewport extent

    LPSIZE lpSize

// original viewport extent

   );

 

 

Parameters

hdc

Identifies the device context.

nXExtent

Specifies the horizontal extent, in device units, of the viewport.

nYExtent

Specifies the vertical extent, in device units, of the viewport.

lpSize

Points to a SIZE1SYGBBP structure. The previous viewport extents (in device units) are placed in this structure. If lpSize is NULL, nothing is returned.

 

Return Values

If the function succeeds, the return value is nonzero.

If the function fails, the return value is zero.

Remarks

When the following mapping modes are set, calls to the SetWindowExtEx11G21GF and SetViewportExtEx 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 SetWindowExtEx function before it calls SetViewportExtEx.

See Also

GetViewportExtEx, SetWindowExtEx, SIZE