NEXTBAND

Syntax

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

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

Parameter Type/Description  

hDC HDC Identifies the device context.  
lpBandRect LPRECT Points to the RECT data 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. It is positive if the escape is successful. Otherwise, it is one of the following values:

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 the 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 NEXTBAND.