Functional specification
34
CDE/Motif PST
CDEnext
When
finish_proc
is called, sometime after
XpGetDocumentData
is called and returns, the
following
status
codes as defined in
<X11/extensions/Print.h>
are returned:
#define XPGetDocFinished
0
/* normal termination */
#define XPGetDocSecondConsumer
1
/* setup error */
#define XPGetDocError
2
/* progress error */
XPGetDocFinshed
(zero) indicates that all intended document data has been delivered by way of
save_proc
. All cancellation events are guaranteed to have arrived by the time
finished_proc
is
called, and they should be taken into consideration for evaluating the validity of the document data
returned.
XPGetDocSecondConsumer
indicates that a consumer had already been established for the print
context. The X Print Server only supports one consumer per print context.
XPGetDocError
indicates that an error has been generated (for example, XPBadContext or
XPBadSequence) and that no further document data will be delivered by the X Print Server to
save_proc
.
After
finish_proc
returns, both
save_proc
and
finish_proc
are unregistered and will no longer
be called.
ERRORS/WARNINGS
XPBadContext
The specified print context id is not valid.
XPBadSequence
The function was not called in the proper order with respect to the other X
Print Service Extension calls (example,
XpGetDocumentData
prior to
XpStartJob
).
SEE ALSO
XpStartJob, XpDestroyContext
2.12
XpStartPage - XpEndPage - XpCancelPage
2.12.1
Short Description
Indicates the beginning and ending of a single print page within a document.
2.12.2
Long Description
NAME
XpStartPage - start a print page
XpEndPage - end a print page
XpCancelPage - cancel a print page