short Escape(hdc, NEWFRAME, NULL, NULL, NULL)
The NEWFRAME printer escape is maintained for backwards compatibility. Applications written for Windows 3.1 should use the StartPage and EndPage functions.
This escape informs the device that the application has finished writing to a page. It is typically used with a printer to direct the device driver to advance to a new page.
hdc
HDC Identifies the device context.
The return value specifies the outcome of the escape. This value 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 Print Manager. |
Do not use the NEXTBAND escape with the NEWFRAME escape. For banding device drivers, graphics device interface (GDI) replays a metafile to the printer, simulating a sequence of NEXTBAND escapes.
The NEWFRAME escape restores the default values of the device context. Consequently, if a font other than the default font is selected when the application calls the NEWFRAME escape, the application must select the font again following the NEWFRAME escape.
The NEWFRAME escape should not be used inside metafiles.