Functional specification
32
CDE/Motif PST
CDEnext
SEE ALSO
2.11
XpGetDocumentData
2.11.1
Short Description
Setup callbacks to retrieve document data from a print context.
2.11.2
Long Description
NAME
XpGetDocumentData - setup callbacks to retrieve document data from a print context.
SYNOPSIS
#include <X11/extensions/Print.h>
Status XpGetDocumentData(
Display
*data_display,
XPContext
context,
XPSaveProc
save_proc,
XPFinishProc
finish_proc,
XPointer
client_data
)
ARGUMENTS
data_display
Specifies a pointer to the
Display
structure; returned from
XOpenDisplay
.
context
The print context from which document data is to be retrieved.
save_proc
A proc to be registered and called repeatedly to save blocks of document
data.
finish_proc
A proc to be registered and called once when the print job has completed
and all document data has been sent to
save_proc
.
client_data
Passed to
save_proc
and
finish_proc
when called.
RETURN VALUE
NULL
if
XpGetDocumentData
encounters an error, non-
NULL
otherwise.
DESCRIPTION
XpGetDocumentData
registers callbacks that allow a "consumer" to continuously retrieve document
data generated in the X Print Server by a separate "producer", where both are referencing the same print
context. Though
XpGetDocumentData
retrieves document data, its lifetime is bounded by