PpPrintNewPage()

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

Synopsis:

int PpPrintNewPage( PpPrintContext_t *pc );

Description:

This function places a New Page command in the draw stream for the specified print context, pc, 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, PpPrintStart() 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.

Examples:

See PpPrintStart().

Classification:

Photon

See also:

PpPrintClose(), PpPrintCreatePC(), PpPrintGetPC(), PpPrintOpen(), PpPrintReleasePC(), PpPrintSetPC(), PpPrintStart(), PpPrintStop(), PpPrintWidget()