NAME    [Toc]    [Back]

       DXmPrintWgtAugmentList  - Defines additional print formats
       and lets you add new options to the  print  widget  option
       menus.

SYNOPSIS    [Toc]    [Back]

       unsigned long int DXmPrintWgtAugmentList(
               Widget pw,
               int list,
               XtPointer data );

PARAMETERS    [Toc]    [Back]

       The print widget.  The print formats or options, indicated
       by the following values:

              ------------------------------------------------------
              Value                 Description
              ------------------------------------------------------
              DXmFILE_BURST_SHEET   Specifies the availability  and
                                    frequency of printed File Burst
                                    Sheets.
              DXmFILE_END_SHEET     Specifies the availability  and
                                    frequency  of  printed File End
                                    Sheets.
              DXmFILE_START_SHEET   Specifies the availability  and
                                    frequency of printed File Start
                                    Sheets.
              DXmINPUT_TRAY         Specifies the input tray  holding
  the  sheet  to be used for
                                    the print job.
              DXmMESSAGE_LOG        Specifies what is  to  be  done
                                    with  error  messages generated
                                    during the print operation.
              DXmOUTPUT_TRAY        Specifies the  output  tray  in
                                    which   the   sheet  is  to  be
                                    placed.
              DXmPAGE_SIZE          Specifies the size of the print
                                    image.
              DXmPRINT_FORMAT       Specifies the print format.
              DXmSHEET_SIZE         Specifies   the   size  of  the
                                    sheet.
              DXmSIDES              Specifies how many sides of the
                                    sheet will be printed.
              ------------------------------------------------------
              One  of the following data structures: DXmPrintFormatStruct,
 which has the following structure:

              typedef struct _DXmPrintFormatStruct {
                   XmString   ui_string;
                   XmString   os_string;
                   XmString   var_string; } DXmPrintFormatStruct;

              Specifies  the  label  displayed in the user interface.
  Specifies a string that identifies the print
              format to the operating system.  Specifies the UNIX
              environment variable that identifies the print format.
   DXmPrintOptionMenuStruct, which has the following
 structure:

              typedef struct _DXmPrintOptionMenuStruct {
                   XmString   ui_string;
                   XmString              os_string;             }
              DXmPrintOptionMenuStruct;

              Specifies  the  label  displayed in the user interface.
  Specifies a string that identifies the print
              option for the operating system.

DESCRIPTION    [Toc]    [Back]

       The   DXmPrintWgtAugmentList  routine  defines  additional
       print formats and lets you add new options  to  the  print
       widget option menus.  Note that the return value (an integer)
 is not required when adding print  formats.  However,
       the  Intrinsics  routines  XtGetValues and XtSetValues use
       that integer when subsequent calls are made on the  option
       menus.

RETURN VALUES    [Toc]    [Back]

       An integer that represents either the number of print formats
 known to the print widget or the identifier of a  new
       option added to the print widget option menu, depending on
       the operation performed.  A Null return indicates that the
       addition of a print format or option was unsuccessful.

SEE ALSO    [Toc]    [Back]

       DXmCreatePrintBox(3X), DXmCreatePrintDialog(3X), DXmPrintWgtPrintJob(3X)

       X Window System Toolkit



                                       DXmPrintWgtAugmentList(3X)