DXmPrintWgtAugmentList(3X)DXmPrintWgtAugmentList(3X)NAMEDXmPrintWgtAugmentList - Defines additional print formats and lets you
add new options to the print widget option menus.
SYNOPSIS
unsigned long int DXmPrintWgtAugmentList(
Widget pw,
int list,
XtPointer data );
PARAMETERS
The print widget. The print formats or options, indicated by the fol‐
lowing 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 hold‐
ing 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 sys‐
tem. Specifies the UNIX environment variable that identifies
the print format. DXmPrintOptionMenuStruct, which has the fol‐
lowing 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 sys‐
tem.
DESCRIPTION
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 for‐
mats. However, the Intrinsics routines XtGetValues and XtSetValues use
that integer when subsequent calls are made on the option menus.
RETURN VALUES
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 ALSODXmCreatePrintBox(3X), DXmCreatePrintDialog(3X), DXmPrintWgtPrint‐
Job(3X)
X Window System Toolkit
DXmPrintWgtAugmentList(3X)