SoXtPrintDialog(3IV)

NAME
     SoXtPrintDialog (SoXtPrintDlog) - dialog box for controlling printing

INHERITS FROM
     SoXtComponent > SoXtPrintDialog

SYNOPSIS
     #include <Inventor_c/Xt/SoXtPrintDialog.h>

     typedef void             SoXtPrintDialogCB(void *userData,
                                   SoXtPrintDialog *dialog)
     typedef SoXtPrintDialog  SoXtPrintDlog

          Functions from class SoXtPrintDialog:

     SoXtPrintDialog *   SoXtPrintDlogCreateAct(Widget parent = NULL, const
                              char *name = NULL, SbBool buildInsideParent =
                              TRUE)
     void                SoXtPrintDlogDelete(SoXtPrintDlog *this)
     void                SoXtPrintDlogSetScene(SoXtPrintDlog *this, SoNode
                              *root )
     SoNode *            SoXtPrintDlogGetScene(SoXtPrintDlog *this)
     void                SoXtPrintDlogSetScenePath(SoXtPrintDlog *this, SoPath
                              *path )
     SoPath *            SoXtPrintDlogGetScenePath(SoXtPrintDlog *this)
     void                SoXtPrintDlogSetAct(SoXtPrintDlog *this, const
                              SoGLRenderAction *act)
     SoGLRenderAction *  SoXtPrintDlogGetAct(SoXtPrintDlog *this)
     void                SoXtPrintDlogSetPrintSizeInches(SoXtPrintDlog *this,
                              SbVec2f *inches)
     void                SoXtPrintDlogSetPrintSize(SoXtPrintDlog *this,
                              SbVec2s * )
     void                SoXtPrintDlogSetBeforePrintCB(SoXtPrintDlog *this,
                              SoXtPrintDialogCB *f, void *userData = NULL)
     void                SoXtPrintDlogSetAfterPrintCB(SoXtPrintDlog *this,
                              SoXtPrintDialogCB *f, void *userData = NULL)

          Functions from class SoXtComponent:

     void                SoXtPrintDlogShow(SoXtPrintDlog *this)
     void                SoXtPrintDlogHide(SoXtPrintDlog *this)
     SbBool              SoXtPrintDlogIsVisible(SoXtPrintDlog *this)
     Widget              SoXtPrintDlogGetWidget(const SoXtPrintDlog *this)
     SbBool              SoXtPrintDlogIsTopLevelShell(const SoXtPrintDlog
                              *this)
     Widget              SoXtPrintDlogGetShellWidget(const SoXtPrintDlog
                              *this)
     Widget              SoXtPrintDlogGetParentWidget(const SoXtPrintDlog
                              *this)
     void                SoXtPrintDlogSetSize(SoXtPrintDlog *this, const
                              SbVec2s *size)

     SbVec2s             SoXtPrintDlogGetSize(SoXtPrintDlog *this)
     Display *           SoXtPrintDlogGetDisplay(SoXtPrintDlog *this)
     void                SoXtPrintDlogSetTitle(SoXtPrintDlog *this, const char
                              *newTitle)
     const char *        SoXtPrintDlogGetTitle(const SoXtPrintDlog *this)
     void                SoXtPrintDlogSetIconTitle(SoXtPrintDlog *this, const
                              char *newIconTitle)
     const char *        SoXtPrintDlogGetIconTitle(const SoXtPrintDlog *this)
     void                SoXtPrintDlogSetWinCloseCB(SoXtPrintDlog *this,
                              SoXtComponentCB *func, void *data = NULL)
     SoXtComponent *     SoXtPrintDlogGetComp(Widget w)
     const char *        SoXtPrintDlogGetWidgetName(const SoXtPrintDlog *this)
     const char *        SoXtPrintDlogGetClassName(const SoXtPrintDlog *this)


DESCRIPTION
     This class provides an interactive widget for setting available options
     used in printing with the SoPrintAction and its subclasses. Options
     include whether to print with hidden lines or not, whether to print using
     the Landscape format, whether to print to a file or a printer.

FUNCTIONS
     SoXtPrintDialog *   SoXtPrintDlogCreateAct(Widget parent = NULL, const
                              char *name = NULL, SbBool buildInsideParent =
                              TRUE)
     void                SoXtPrintDlogDelete(SoXtPrintDlog *this)
          Constructors and destructor.

     void                SoXtPrintDlogSetScene(SoXtPrintDlog *this, SoNode
                              *root )
     SoNode *            SoXtPrintDlogGetScene(SoXtPrintDlog *this)
     void                SoXtPrintDlogSetScenePath(SoXtPrintDlog *this, SoPath
                              *path )
     SoPath *            SoXtPrintDlogGetScenePath(SoXtPrintDlog *this)
          Sets/gets the root node or path to nodes to be used for printing.

     void                SoXtPrintDlogSetAct(SoXtPrintDlog *this, const
                              SoGLRenderAction *act)
     SoGLRenderAction *  SoXtPrintDlogGetAct(SoXtPrintDlog *this)
          Sets/gets the render action to be used when printing.

     void                SoXtPrintDlogSetPrintSizeInches(SoXtPrintDlog *this,
                              SbVec2f *inches)
     void                SoXtPrintDlogSetPrintSize(SoXtPrintDlog *this,
                              SbVec2s * )
          Sets/gets the size of the printed image. This is typically the same
          size as the window displaying the scene to be printed.

     void                SoXtPrintDlogSetBeforePrintCB(SoXtPrintDlog *this,
                              SoXtPrintDialogCB *f, void *userData = NULL)
     void                SoXtPrintDlogSetAfterPrintCB(SoXtPrintDlog *this,
                              SoXtPrintDialogCB *f, void *userData = NULL)
          Two callbacks are maintained, one which gets called just before a
          print is executed, and one which gets called after a print is
          executed. These two methods sets the appropriate callback function
          (set these to NULL to remove the callback).


SEE ALSO
     SoGLRenderAction, SoXtComponent