PpPrintNewPage()

Place a page break in the draw stream for a Print Context

Synopsis:

int PpPrintNewPage( PpPrintContext_t *pc );

Arguments:

pc

The pointer to a PpPrintContext_t structure that was returned by PpCreatePC().

Library:

ph

Description:

This function places a New Page command in the draw stream for the specified print context, followed by all the changes made to the print context since PpPrintNewPage() was called or the print context was opened (initialized).

If the print context isn't currently active, PpContinueJob() is called before the New Page command is inserted. The draw context that was active when the call was made is restored before PpPrintNewPage() returns.

Returns:

0

Success.

-1

The print context couldn't be made active, probably because the required working files couldn't be created. See errno for the specific error.

Classification:

Photon

See also:

PpContinueJob(), PpCreatePC(), PpEndJob(), PpGetPC(), PpPrintContext_t, PpReleasePC(), PpPrintWidget(), PpSetPC(), PpStartJob(), PpSuspendJob()

Printing in the Photon Programmer's Guide