Manual Pages for UNIX Operating System command usage for man XpCancelPage

XPRINT FUNCTIONS                                XpCancelPage(3Xp)



NAME
     XpCancelPage - Cancels a print page.

SYNOPSIS
     cc [ flag... ] file... -lXp [ library... ]
           cc [ flag... ] file... -lXp [ library... ]
           #include 

     void XpCancelPage ( display, discard )
           Display *display;
           Bool discard;

ARGUMENTS
     display
          Specifies a pointer to the Display structure;  returned
          from XOpenDisplay.

     discard
          When TRUE, specifies that XPPrintNotify events  with  a
          detail of XPEndPageNotify should be discarded.

DESCRIPTION
     XpCancelPage cancels an in-progress print page. If  the  job
     was  started with output_mode XPGetData then the data stream
     to XpGetDocumentData is interrupted; no further data for the
     current  page is generated but data for subsequent pages can
     be generated. For  many  page  description  languages,  such
     arbitrary interruptions may invalidate the output.

     If the job was started with output_mode XPSpool then depend-
     ing on the driver and spooler implementation the entire page
     may be canceled or a partial page may be generated.

     If discard is True all XPPrintNotify events  with  a  detail
     field  of  XPEndPageNotify are discarded before XpCancelPage
     returns.

     For clients selecting XPPrintMask (see  XpSelectInput),  the
     event  XPPrintNotify  is generated with its detail field set
     to XPEndPageNotify when the X  Print  Server  has  completed
     XpCancelPage.

DIAGNOSTICS
     XPBadSequence  The function was not  called  in  the  proper
                    order  with respect to the other X Print Ser-
                    vice Extension calls; for  example,  XpStart-
                    Page  was  called  before  XpStartJob  or was
                    called for a type XPDocRaw document.

SEE ALSO
     XpGetDocumentData(3Xp), XpSelectInput(3Xp), XpStartJob(3Xp),
     XpStartPage(3Xp)



X Version 11        Last change: libXp 1.0.0                    1






XPRINT FUNCTIONS                                XpCancelPage(3Xp)



ATTRIBUTES
     See attributes(5) for descriptions of the  following  attri-
     butes:

     ____________________________________________________________
    |       ATTRIBUTE TYPE        |       ATTRIBUTE VALUE       |
    |_____________________________|_____________________________|
    | Availability                | x11/library/libxp           |
    |_____________________________|_____________________________|
    | Interface Stability         | Committed                   |
    |_____________________________|_____________________________|
    | MT-Level                    | See XInitThreads(3X11)      |
    |_____________________________|_____________________________|










































X Version 11        Last change: libXp 1.0.0                    2