SetViewportExtEx

  BOOL SetViewportExtEx(hdc, nXExtent, nYExtent, lpSize)    
  HDC hdc; /* handle of device context */
  int nXExtent; /* new horizontal viewport-extent */
  int nYExtent; /* new vertical viewport-extent */
  LPSIZE lpSize; /* original viewport extent */

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

Parameters

hdc

Identifies the device context.

nXExtent

Specifies the horizontal extent of the viewport (in device units).

nYExtent

Specifies the vertical extent of the viewport (in device units).

lpSize

Points to a SIZE structure. The previous extents of the viewport (in device units) are placed in this structure. If lpSize is NULL, nothing is returned. The SIZE structure has the following format:

typedef struct tagSIZE { /* siz */

LONG cx;

LONG cy;

} SIZE;

Return Value

The return value is TRUE if the function is successful. Otherwise it is FALSE.

Comments

When the following mapping modes are set, calls to the SetWindowExtEx 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