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 NEWFRAME 1 
short Control(lpDevice, NEWFRAME, NULL, NULL)
LPPDEVICE lpDevice;
 
The NEWFRAME escape informs the device that the application has finished
writing to a page. This escape is used typically with a printer to direct
the device driver to advance to a new page by performing a page-break
algorithm or form feed.
 
Parameter  Description
────────────────────────────────────────────────────────────────────────────
 
lpDevice   Points to a PDEVICE structure specifying the destination device.
 
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
 
 
                                      ♦