| GNOME Print UI Reference Manual | ||||
|---|---|---|---|---|
| Top | Description | Object Hierarchy | Implemented Interfaces | Properties | ||||
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" gchar* : 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.