SET_BOUNDS

short Escape(hdc, SET_BOUNDS, sizeof(RECT),lpInData, NULL)

The SET_BOUNDS printer escape sets the bounding rectangle for the picture being produced by the device driver supporting the given device context. This escape is used when creating images in a file format such as Encapsulated PostScript (EPS) and Hewlett-Packard Graphics Language (HPGL) for which there is a device driver.

Parameters

hdc

HDC Identifies the device context.

lpInData

LPRECT Points to a RECT structure that specifies in device coordinates a rectangle that bounds the image to be output.

Return Value

The return value is nonzero if the escape was successful. Otherwise, it is zero.

Comments

An application should issue this escape before each page in the image. For single-page images, this escape should be issued immediately before the STARTDOC escape.

When an application uses coordinate-transformation escapes, device drivers may not perform bounding box calculations correctly. When an application uses the SET_BOUNDS escape, the driver does not have to calculate the bounding box.

Applications should always use this escape to ensure support for the Encapsulated PostScript (EPS) printing capabilities.