NEXTBAND

short Escape(hdc, NEXTBAND, NULL, NULL,lpBandRect)

The NEXTBAND printer escape informs the device driver that the application has finished writing to a band, causing the device driver to send the band to Print Manager and return the coordinates of the next band. Applications that process banding themselves use this escape.

Parameters

hdc

HDC Identifies the device context.

lpBandRect

LPRECT Points to the RECT structure that will receive the next band coordinates. The device driver copies the device coordinates of the next band into this structure.

Return Value

The return value specifies the outcome of the escape. This value is positive if the escape is successful. A return value of zero indicates that an error occurred. In addition, the following error values are defined:

Value Meaning

SP_APPABORT Job was terminated because the application's Abort function returned zero.
SP_ERROR General error.
SP_OUTOFDISK Not enough disk space is currently available for spooling, and no more space will become available.
SP_OUTOFMEMORY Not enough memory is available for spooling.
SP_USERABORT User terminated the job through Print Manager.

Comments

The NEXTBAND escape sets the band rectangle to the empty rectangle when printing reaches the end of a page.

Do not use the NEWFRAME escape with the NEXTBAND escape.

The NEXTBAND escape should not be used inside metafiles.