DXmPrintWgtAugmentList(3X) — Subroutines
Digital
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;
caddr_t data;
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.
Arguments
pwThe print widget.
listThe 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 |
dataOne of the following data structures:
•DXmPrintFormatStruct, which has the following structure:
typedef struct _DXmPrintFormatStruct
{
} DXmPrintFormatStruct;
1The label displayed in the user interface
2Specifies a string that identifies the print format to the operating system
3The UNIX environment variable that identifies the print format
•DXmPrintOptionMenuStruct , which has the following structure:
typedef struct _DXmPrintOptionMenuStruct
{
} DXmPrintOptionMenuStruct;
1The label displayed in the user interface
2Specifies a string that identifies the print option for the operating system
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, DXmCreatePrintDialog, and DXmPrintWgtPrintJob.