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 (pw,list,data)
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
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 for‐
mat.
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. DXmPrintOptionMenuS‐
truct, 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
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.
RELATED INFORMATIONDXmCreatePrintBox(3X), DXmCreatePrintDialog(3X), DXmPrintWgtPrint‐
Job(3X)
X Window System Toolkit
DECwindows Motif Guide to Application Programming
DXmPrintWgtAugmentList(3X)