Important Notice

The pages on this site contain documentation for very old MS-DOS software, purely for historical purposes. If you're looking for up-to-date documentation, particularly for programming, you should not rely on the information found here, as it will be woefully out of date.

                                                     ◄Up► ◄Next► ◄Previous►
────────────────────────────────────────────────────────────────────────────
 
#define NEXTBAND 3 
short Control(lpDevice, NEXTBAND, lpInData, lpBandRect)
LPPDEVICE lpDevice;
LPPOINT lpInData;
LPRECT lpBandRect;
 
The NEXTBAND escape informs the device driver that the application has
finished writing to a band. The device driver then sends the band to the
printer and returns the coordinates of the next band.
 
Parameter   Description
────────────────────────────────────────────────────────────────────────────
 
lpDevice    Points to a PDEVICE structure specifying the destination
            device.
 
lpInData    Points to a POINT structure that receives the horizontal and
            vertical scaling factors in the x and y members respectively.
 
            The shift count in the POINT structure pointed to by the
            lpInData parameter is used for devices such as laser printers
            that support graphics at a lower resolution than text.
 
lpBandRect  Points to a RECT structure that receives the next band
            coordinates. The device driver copies the device coordinates of
            the next band into this structure.
 
Return Value
 
The return value is positive if the escape is successful. Otherwise, it is
one of the following values.
 
Value                Meaning
────────────────────────────────────────────────────────────────────────────
SP_ERROR (-1)        A general error condition or general error in banding
                     occurred.
 
SP_APPABORT (-2)     The job was stopped because the application's callback
                     function returned FALSE (0).
 
SP_USERABORT (-3)    The user stopped the print job by choosing the Delete
                     button from Print Manager.
 
SP_OUTOFDISK (-4)    A lack of disk space caused the job to stop. There is
                     not enough disk space to create or extend the Print
                     Manager temporary file.
 
SP_OUTOFMEMORY (-5)  A lack of memory caused the job to stop.
 
See Also
 
PDEVICE, POINT, RECT
 
 
                                      ♦