DXmPrintWgtAugmentList(3X)
NAME
DXmPrintWgtAugmentList − 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 following values:
| Value@Description | |
| Specifies the availability and frequency of printed File Burst Sheets. | |
| Specifies the availability and frequency of printed File End Sheets. | |
| Specifies the availability and frequency of printed File Start Sheets. | |
| Specifies the input tray holding the sheet to be used for the print job. | |
| Specifies what is to be done with error messages generated during the print operation. | |
| Specifies the output tray in which the sheet is to be placed. | |
| Specifies the size of the print image. | |
| Specifies the print format. | |
| Specifies the size of the sheet. | |
| 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
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
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 INFORMATION
DXmCreatePrintBox(3X), DXmCreatePrintDialog(3X), DXmPrintWgtPrintJob(3X)
X Window System Toolkit
DECwindows Motif Guide to Application Programming