Dt/Print.h(file formats)                           Dt/Print.h(file formats)




 NAME    [Toc]    [Back]
      Dt/Print.h - print definitions

 SYNOPSIS    [Toc]    [Back]
      #include <Dt/Print.h>

 DESCRIPTION    [Toc]    [Back]
      The Dt/Print.h header defines resource names, resource values,
      callback reasons, callback structures, and function prototypes for the
      Print widget class.

      The Dt/Print.h header defines the following resource names:

      DtNcancelCallback
                cancelCallback

      DtNclosePrintDisplayCallback
                closePrintDisplayCallback

      DtNcopies copies

      DtNdescription
                description

      DtNdestroyContextCallback
                destroyContextCallback

      DtNfileName
                fileName

      DtNminimizeButtons
                minimizeButtons (if not otherwise named)

      DtNoptionCount
                optionCount

      DtNoptions
                options

      DtNprintCallback
                printCallback

      DtNprintDestination
                printDestination

      DtNprinterInfoProc
                printerInfoProc

      DtNprinterName
                printerName




                                    - 1 -       Formatted:  January 24, 2005






 Dt/Print.h(file formats)                           Dt/Print.h(file formats)




      DtNprintSetupMode
                printSetupMode

      DtNselectFileProc
                selectFileProc

      DtNselectPrinterProc
                selectPrinterProc

      DtNsetupCallback
                setupCallback

      DtNverifyPrinterProc
                verifyPrinterProc

      DtNworkAreaLocation
                workAreaLocation

      DtCCancelCallback
                CancelCallback

      DtCClosePrintDisplayCallback
                ClosePrintDisplayCallback

      DtCCopies Copies

      DtCDescription
                Description

      DtCDestroyContextCallback
                DestroyContextCallback

      DtCFileName
                FileName

      DtCMinimizeButtons
                MinimizeButtons (if not otherwise named)

      DtCOptionCount
                OptionCount

      DtCOptions
                Options

      DtCPrintCallback
                PrintCallback

      DtCPrintDestination
                PrintDestination





                                    - 2 -       Formatted:  January 24, 2005






 Dt/Print.h(file formats)                           Dt/Print.h(file formats)




      DtCPrinterInfoProc
                PrinterInfoProc

      DtCPrinterName
                PrinterName

      DtCPrintSetupMode
                PrintSetupMode

      DtCSelectFileProc
                SelectFileProc



      DtCSelectPrinterProc
                SelectPrinterProc

      DtCSetupCallback
                SetupCallback

      DtCVerifyPrinterProc
                VerifyPrinterProc

      DtCWorkAreaLocation
                WorkAreaLocation

      DtRPrintSetupProc
                PrintSetupProc

      The Dt/Print.h header declares the following values for the
      DtNsetupMode resource:

      DtPRINT_SETUP_PLAIN    [Toc]    [Back]
      DtPRINT_SETUP_XP

      The Dt/Print.h header declares the following values for the
      DtNworkAreaLocation resource:

      DtWORK_AREA_NONE    [Toc]    [Back]
      DtWORK_AREA_TOP
      DtWORK_AREA_TOP_AND_BOTTOM
      DtWORK_AREA_BOTTOM

      The Dt/Print.h header declares the following values for the
      DtNprintDestination resource:

      DtPRINT_NO_DESTINATION    [Toc]    [Back]
      DtPRINT_TO_PRINTER
      DtPRINT_TO_FILE





                                    - 3 -       Formatted:  January 24, 2005






 Dt/Print.h(file formats)                           Dt/Print.h(file formats)




      The Dt/Print.h header declares the following values for the
      DtNprinterNameMode resource:

      DtSHORT_NAME    [Toc]    [Back]
      DtMEDIUM_NAME
      DtLONG_NAME

      The Dt/Print.h header declares the following mode values for
      DtPrintSetupBoxResetConnection():

      typedef enum {
          DtPRINT_CLOSE_CONNECTION,
          DtPRINT_RELEASE_CONNECTION
      } DtPrintResetConnectionMode;

      The Dt/Print.h header declares the following callback reasons:

      DtPRINT_CR_NONE
      DtPRINT_CR_CANCEL
      DtPRINT_CR_CLOSE_PRINT_DISPLAY
      DtPRINT_CR_PRINT
      DtPRINT_CR_SETUP

      The Dt/Print.h header declares the following return values for the
      DtPrint procedure:

      DtPRINT_SUCCESS,
      DtPRINT_BAD_PARM,
      DtPRINT_FAILURE,
      DtPRINT_INVALID_DISPLAY,
      DtPRINT_NOT_XP_DISPLAY,
      DtPRINT_NO_CONNECTION,
      DtPRINT_NO_DEFAULT,
      DtPRINT_NO_DEFAULT_DISPLAY,
      DtPRINT_NO_PRINTER,
      DtPRINT_PRINTER_MISSING

      DtPRINT_SUCCESS    [Toc]    [Back]
                The X printer connection was successfully obtained.

      DtPRINT_BAD_PARM    [Toc]    [Back]
                The value passed for print_data is NULL, or the value of the
                DtNprintSetupMode resource for wid is not DtPRINT_SETUP_XP.

      DtPRINT_FAILURE    [Toc]    [Back]
                The X printer connection failed.

      DtPRINT_INVALID_DISPLAY    [Toc]    [Back]
                The indicated X print server could not be found.





                                    - 4 -       Formatted:  January 24, 2005






 Dt/Print.h(file formats)                           Dt/Print.h(file formats)




      DtPRINT_NOT_XP_DISPLAY    [Toc]    [Back]
                The indicated X server does not support the X Printing
                Extension.

      DtPRINT_NO_CONNECTION    [Toc]    [Back]
                An open X print server connection is not currently being
                managed by the DtPrintSetupBox.

      DtPRINT_NO_PRINTER    [Toc]    [Back]
                The indicated printer could not be found on the X print
                server, or a default printer could not be determined.

      The Dt/Print.h header declares the following class record constants:

      WidgetClass dtPrintSetupBoxWidgetClass;

      _DtPrintSetupBoxClassRec * DtPrintSetupBoxWidgetClass;
      _DtPrintSetupBoxRec      * DtPrintSetupBoxWidget;

      The header defines the following callback prototypes:

      typedef struct _DtPrintSetupData
      {
          String     printer_name;
          Display    *print_display;
          XPContext  print_context;
          XtEnum     destination;
          String     dest_info;
      } DtPrintSetupData;

      typedef struct _DtPrintSetupCallbackStruct
      {
          int        reason;
          XEvent          *event;
          DtPrintSetupData     *print_data;
      } DtPrintSetupCallbackStruct;

      The header defines the following functions:

      Widget DtCreatePrintSetupBox(
                          Widget   p,
                          String   name,
                          ArgList  args,
                          Cardinal n);

      Widget DtCreatePrintSetupDialog(
                          Widget   ds_p,
                          String   name,
                          ArgList  sb_args,
                          Cardinal sb_n);




                                    - 5 -       Formatted:  January 24, 2005






 Dt/Print.h(file formats)                           Dt/Print.h(file formats)




      DtPrintSetupData* DtPrintCopySetupData(
                                 DtPrintSetupData*        target,
                                 const DtPrintSetupData*  source);

      XtEnum DtPrintFillSetupData(
                         Widget          psub,
                         DtPrintSetupData*   print_data);

      void DtPrintFreeSetupData(
                       DtPrintSetupData* target);

      XtEnum DtPrintResetConnection(
                           Widget                     psub,
                           DtPrintResetConnectionMode m);

 SEE ALSO    [Toc]    [Back]
      DtCreatePrintSetupBox(3), DtCreatePrintSetupDialog(3),
      DtPrintCopySetupData(3), DtPrintFillSetupData(3),
      DtPrintFreeSetupData(3), DtPrintResetConnection(3),
      DtPrintSetupBox(3), Print(4), and dtprintinfo(1).


                                    - 6 -       Formatted:  January 24, 2005