|  |  |  | GNOME Print UI Reference Manual |  | 
|---|---|---|---|---|
                    GnomePrintDialog;
                    GnomePrintDialogClass;
enum                GnomePrintRangeType;
GtkWidget*          gnome_print_dialog_new              (GnomePrintJob *gpj,
                                                         const guchar *title,
                                                         gint flags);
void                gnome_print_dialog_construct        (GnomePrintDialog *gpd,
                                                         const guchar *title,
                                                         gint flags);
void                gnome_print_dialog_construct_range_custom
                                                        (GnomePrintDialog *gpd,
                                                         GtkWidget *custom);
void                gnome_print_dialog_construct_range_any
                                                        (GnomePrintDialog *gpd,
                                                         gint flags,
                                                         GtkWidget *range_widget,
                                                         const guchar *currentlabel,
                                                         const guchar *rangelabel);
void                gnome_print_dialog_construct_range_page
                                                        (GnomePrintDialog *gpd,
                                                         gint flags,
                                                         gint start,
                                                         gint end,
                                                         const guchar *currentlabel,
                                                         const guchar *rangelabel);
GnomePrintRangeType gnome_print_dialog_get_range        (GnomePrintDialog *gpd);
int                 gnome_print_dialog_get_range_page   (GnomePrintDialog *gpd,
                                                         gint *start,
                                                         gint *end);
void                gnome_print_dialog_get_copies       (GnomePrintDialog *gpd,
                                                         gint *copies,
                                                         gboolean *collate);
void                gnome_print_dialog_set_copies       (GnomePrintDialog *gpd,
                                                         gint copies,
                                                         gint collate);
GnomePrintConfig*   gnome_print_dialog_get_config       (GnomePrintDialog *gpd);
GObject +----GInitiallyUnowned +----GtkObject +----GtkWidget +----GtkContainer +----GtkBin +----GtkWindow +----GtkDialog +----GnomePrintDialog
"content-selector" GnomePrintContentSelector : Read / Write "flags" gint : Read / Write "notebook" GtkNotebook : Read "page-selector" GnomePrintPageSelector : Read "print-config" GnomePrintConfig : Read / Write "printer-selector" GnomePrinterSelector : Read "title" gchararray : Read / Write
typedef enum {
	GNOME_PRINT_RANGETYPE_NONE,
	GNOME_PRINT_RANGETYPE_CUSTOM,
	GNOME_PRINT_RANGETYPE_PAGES
} GnomePrintRangeType;
GtkWidget* gnome_print_dialog_new (GnomePrintJob *gpj, const guchar *title, gint flags);
Create a new gnome-print-dialog window.
The following options flags are available: GNOME_PRINT_DIALOG_RANGE: A range widget container will be created. A range widget must be created separately, using one of the gnome_print_dialog_construct_* functions. GNOME_PRINT_DIALOG_COPIES: A copies widget will be created.
| 
 | GnomePrintJob | 
| 
 | Title of window. | 
| 
 | Options for created widget. | 
| Returns : | A newly created and initialised widget. | 
void gnome_print_dialog_construct (GnomePrintDialog *gpd, const guchar *title, gint flags);
Used for language bindings to post-initialise an object instantiation.
| 
 | A created GnomePrintDialog. | 
| 
 | Title of the window. | 
| 
 | Initialisation options, see gnome_print_dialog_new(). | 
void                gnome_print_dialog_construct_range_custom
                                                        (GnomePrintDialog *gpd,
                                                         GtkWidget *custom);
Install a custom range specification widget.
| 
 | A GnomePrintDialog for which a range was requested. | 
| 
 | A widget which will be placed in a "Range" frame in the main display. | 
void                gnome_print_dialog_construct_range_any
                                                        (GnomePrintDialog *gpd,
                                                         gint flags,
                                                         GtkWidget *range_widget,
                                                         const guchar *currentlabel,
                                                         const guchar *rangelabel);
Create a generic range area within the print range dialogue. The flags field contains a mask of which options you wish displayed:
GNOME_PRINT_RANGE_CURRENT: A label currentlabel will be displayed.
GNOME_PRINT_RANGE_ALL: A label "All" will be displayed.
GNOME_PRINT_RANGE_RANGE: A label rangelabel will be displayed, next
to the range specification widget range_widget.
GNOME_PRINT_RANGE_SELECTION: A label "Selection" will be displayed.
| 
 | An initialise GnomePrintDialog, which can contain a range. | 
| 
 | Options flags, which ranges are displayed. | 
| 
 | Widget to display for the range option. | 
| 
 | Label to display next to the 'current page' button. | 
| 
 | Label to display next to the 'range' button. | 
void                gnome_print_dialog_construct_range_page
                                                        (GnomePrintDialog *gpd,
                                                         gint flags,
                                                         gint start,
                                                         gint end,
                                                         const guchar *currentlabel,
                                                         const guchar *rangelabel);
Construct a generic page/sheet range area.
| 
 | An initialise GnomePrintDialog, which can contain a range. | 
| 
 | Option flags.  See gnome_print_dialog_construct_any(). | 
| 
 | First page which may be printed. | 
| 
 | Last page which may be printed. | 
| 
 | Label text for current option. | 
| 
 | Label text for range option. | 
GnomePrintRangeType gnome_print_dialog_get_range (GnomePrintDialog *gpd);
Return the range option selected by the user. This is a bitmask with only 1 bit set, out of:
GNOME_PRINT_RANGE_CURRENT: The current option selected. GNOME_PRINT_RANGE_ALL: The all option selected. GNOME_PRINT_RANGE_RANGE The range option selected. GNOME_PRINT_RANGE_SELECTION: The selection option selected.
| 
 | A GnomePrintDialog with a range display. | 
| Returns : | A bitmask with one option set. | 
int gnome_print_dialog_get_range_page (GnomePrintDialog *gpd, gint *start, gint *end);
Retrieves the user choice for range type and range, if the user has requested a range of pages to print.
| 
 | A GnomePrintDialog with a page range display. | 
| 
 | Return for the user-specified start page. | 
| 
 | Return for the user-specified end page. | 
| Returns : | A bitmask with the user-selection set.  See gnome_print_dialog_get_range(). | 
void gnome_print_dialog_get_copies (GnomePrintDialog *gpd, gint *copies, gboolean *collate);
Retrieves the number of copies and collation indicator from the print dialogue. If the print dialogue does not have a copies indicator, then a default of 1 copy is returned.
| 
 | A GnomePrintDialog with a copies display. | 
| 
 | Return for the number of copies. | 
| 
 | Return for collation flag. | 
void gnome_print_dialog_set_copies (GnomePrintDialog *gpd, gint copies, gint collate);
Sets the print copies and collation status in the print dialogue.
| 
 | A GnomePrintDialog with a copies display. | 
| 
 | New number of copies. | 
| 
 | New collation status. | 
GnomePrintConfig* gnome_print_dialog_get_config (GnomePrintDialog *gpd);
| 
 | |
| Returns : | 
"content-selector" property"content-selector" GnomePrintContentSelector : Read / Write
Content selector.
"flags" property"flags" gint : Read / Write
Flags.
Allowed values: >= -2147483647
Default value: 0
"print-config" property"print-config" GnomePrintConfig : Read / Write
Printing Configuration to be used.