PuiCreatePrintDialog(3X)

NAME
     PuiCreatePrintDialog - create a PrintBox dialog

SYNOPSIS
     #include <Sgm/PrintBox.h>

     Widget PuiCreatePrintDialog(Widget parent,
                                 String name,
                                 ArgList arglist,
                                 Cardinal argcount);

DESCRIPTION
     PuiCreatePrintDialog is a convenience function that creates a Motif
     DialogShell and an unmanaged PrintBox child of that shell. A PrintBox
     dialog provides a graphical interface for submitting print jobs under the
     System V print spooling system.  Print jobs may be submitted as
     filenames, a file descriptor or as a pointer to a text buffer. The
     PrintBox dialog includes the following items:

     - A print file entry text field (for file based jobs)
     - A scrolling list of available printers
     - Print option controls
     - Up to five action area push buttons

     By default three action area push buttons are managed and are labeled
     Print, Cancel and Help. The remaining two buttons are unmanaged. The
     PrintBox dialog accepts one child as a work area. This area may be used
     for application specific printing related controls.

     parent         Specifies the ID of the parent widget.

     name           Specifies the instance name of the created widget.

     arglist        Specifies the widget resource argument list

     argcount       Specifies the number of attribute/value pairs in the
                    argument list (arglist)

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

RETURN VALUE
     The widget ID of the newly instantiated PrintBox is returned.

NOTE
     Use XtManageChild to pop up the dialog created by PuiCreatePrintDialog
     and use XtUnmanageChild to pop down the dialog.

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