PuiPrintBoxDoPrint(3X)

NAME
     PuiPrintBoxDoPrint - invoke PrintBox printing

SYNOPSIS
     #include <Sgm/PrintBox.h>

     void PuiPrintBoxDoPrint(Widget widget);

DESCRIPTION
     PuiPrintBoxDoPrint provides a programmatic interface to the PrintBox
     widget's printing mechanism. A call to PuiPrintBoxDoPrint simulates
     pressing the Print button on the PrintBox widget panel.

     PuiPrintBoxDoPrint first calls all functions registered on the
     PuiNprintCallback list. Next, if the PuiNprintingPolicy resource is set
     to PuiWIDGET_PRINTING, the PrintBox widget's internal printing function
     is called to print the specified file(s), or buffer. If
     PuiNprintingPolicy is set to PuiAPPLICATION_PRINTING, the widget's
     internal printing routine is not called, and it becomes the application's
     responsibility to submit the job for printing.

     If an error occurs when submitting the print job to the spooling system,
     the functions registered on the PuiNerrorCallback list will be called. If
     the print job is successfully submitted, the functions registered on the
     PuiNjobInfoCallback list will be called.

     For a complete definition of the PrintBox and its associated resources,
     see PuiPrintBox(3X).

SEE ALSO
     PuiPrintBox(3X), libprintui(3X)