| Top |  |
 |
 |
 |
Functions
Properties
| gint | current-page | Read / Write |
| gboolean | embed-page-setup | Read / Write |
| gboolean | has-selection | Read / Write |
| GtkPrintCapabilities | manual-capabilities | Read / Write |
| GtkPageSetup * | page-setup | Read / Write |
| GtkPrintSettings * | print-settings | Read / Write |
| GtkPrinter * | selected-printer | Read |
| gboolean | support-selection | Read / Write |
Object Hierarchy
GObject ╰── GInitiallyUnowned ╰── GtkObject ╰── GtkWidget ╰── GtkContainer ╰── GtkBin ╰── GtkWindow ╰── GtkDialog ╰── GtkPrintUnixDialog
Description
GtkPrintUnixDialog implements a print dialog for platforms which don't provide a native print dialog, like Unix. It can be used very much like any other GTK+ dialog, at the cost of the portability offered by the high-level printing API
In order to print something with GtkPrintUnixDialog, you need
to use gtk_print_unix_dialog_get_selected_printer() to obtain
a GtkPrinter object and use it to construct a GtkPrintJob using
gtk_print_job_new().
GtkPrintUnixDialog uses the following response values:
for the "Print" button |
|
for the "Preview" button |
|
for the "Cancel" button |
Printing support was added in GTK+ 2.10.
GtkPrintUnixDialog as GtkBuildable
The GtkPrintUnixDialog implementation of the GtkBuildable interface exposes its
notebook internal children with the name "notebook".
Example 52. A GtkPrintUnixDialog UI definition fragment.
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 |
<object class="GtkPrintUnixDialog" id="dialog1"> <child internal-child="notebook"> <object class="GtkNotebook" id="notebook"> <child> <object class="GtkLabel" id="tabcontent"> <property name="label">Content on notebook tab</property> </object> </child> <child type="tab"> <object class="GtkLabel" id="tablabel"> <property name="label">Tab label</property> </object> <packing> <property name="tab_expand">False</property> <property name="tab_fill">False</property> </packing> </child> </object> </child> </object> |
Functions
gtk_print_unix_dialog_new ()
GtkWidget * gtk_print_unix_dialog_new (const gchar *title,GtkWindow *parent);
Creates a new GtkPrintUnixDialog.
Since 2.10
gtk_print_unix_dialog_set_page_setup ()
void gtk_print_unix_dialog_set_page_setup (GtkPrintUnixDialog *dialog,GtkPageSetup *page_setup);
Sets the page setup of the GtkPrintUnixDialog.
Since 2.10
gtk_print_unix_dialog_get_page_setup ()
GtkPageSetup *
gtk_print_unix_dialog_get_page_setup (GtkPrintUnixDialog *dialog);
Gets the page setup that is used by the GtkPrintUnixDialog.
Since 2.10
gtk_print_unix_dialog_set_current_page ()
void gtk_print_unix_dialog_set_current_page (GtkPrintUnixDialog *dialog,gint current_page);
Sets the current page number. If current_page
is not -1, this enables
the current page choice for the range of pages to print.
Since 2.10
gtk_print_unix_dialog_get_current_page ()
gint
gtk_print_unix_dialog_get_current_page
(GtkPrintUnixDialog *dialog);
Gets the current page of the GtkPrintDialog.
Since 2.10
gtk_print_unix_dialog_set_settings ()
void gtk_print_unix_dialog_set_settings (GtkPrintUnixDialog *dialog,GtkPrintSettings *settings);
Sets the GtkPrintSettings for the GtkPrintUnixDialog. Typically, this is used to restore saved print settings from a previous print operation before the print dialog is shown.
Since 2.10
gtk_print_unix_dialog_get_settings ()
GtkPrintSettings *
gtk_print_unix_dialog_get_settings (GtkPrintUnixDialog *dialog);
Gets a new GtkPrintSettings object that represents the current values in the print dialog. Note that this creates a new object, and you need to unref it if don't want to keep it.
Since 2.10
gtk_print_unix_dialog_get_selected_printer ()
GtkPrinter *
gtk_print_unix_dialog_get_selected_printer
(GtkPrintUnixDialog *dialog);
Gets the currently selected printer.
Since 2.10
gtk_print_unix_dialog_add_custom_tab ()
void gtk_print_unix_dialog_add_custom_tab (GtkPrintUnixDialog *dialog,GtkWidget *child,GtkWidget *tab_label);
Adds a custom tab to the print dialog.
Parameters
dialog |
||
child |
the widget to put in the custom tab |
|
tab_label |
the widget to use as tab label |
Since 2.10
gtk_print_unix_dialog_set_support_selection ()
void gtk_print_unix_dialog_set_support_selection (GtkPrintUnixDialog *dialog,gboolean support_selection);
Sets whether the print dialog allows user to print a selection.
Since 2.18
gtk_print_unix_dialog_get_support_selection ()
gboolean
gtk_print_unix_dialog_get_support_selection
(GtkPrintUnixDialog *dialog);
Gets the value of “support-selection” property.
Since 2.18
gtk_print_unix_dialog_set_has_selection ()
void gtk_print_unix_dialog_set_has_selection (GtkPrintUnixDialog *dialog,gboolean has_selection);
Sets whether a selection exists.
Since 2.18
gtk_print_unix_dialog_get_has_selection ()
gboolean
gtk_print_unix_dialog_get_has_selection
(GtkPrintUnixDialog *dialog);
Gets the value of “has-selection” property.
Since 2.18
gtk_print_unix_dialog_set_embed_page_setup ()
void gtk_print_unix_dialog_set_embed_page_setup (GtkPrintUnixDialog *dialog,gboolean embed);
Embed page size combo box and orientation combo box into page setup page.
Since 2.18
gtk_print_unix_dialog_get_embed_page_setup ()
gboolean
gtk_print_unix_dialog_get_embed_page_setup
(GtkPrintUnixDialog *dialog);
Gets the value of “embed-page-setup” property.
Since 2.18
gtk_print_unix_dialog_get_page_setup_set ()
gboolean
gtk_print_unix_dialog_get_page_setup_set
(GtkPrintUnixDialog *dialog);
Gets the page setup that is used by the GtkPrintUnixDialog.
Since 2.18
gtk_print_unix_dialog_set_manual_capabilities ()
void gtk_print_unix_dialog_set_manual_capabilities (GtkPrintUnixDialog *dialog,GtkPrintCapabilities capabilities);
This lets you specify the printing capabilities your application supports. For instance, if you can handle scaling the output then you pass GTK_PRINT_CAPABILITY_SCALE. If you don't pass that, then the dialog will only let you select the scale if the printing system automatically handles scaling.
Since 2.10
gtk_print_unix_dialog_get_manual_capabilities ()
GtkPrintCapabilities
gtk_print_unix_dialog_get_manual_capabilities
(GtkPrintUnixDialog *dialog);
Gets the value of “manual-capabilities” property.
Since 2.18
Types and Values
enum GtkPrintCapabilities
An enum for specifying which features the print dialog should offer.
If neither GTK_PRINT_CAPABILITY_GENERATE_PDF nor
GTK_PRINT_CAPABILITY_GENERATE_PS is specified, GTK+ assumes that all
formats are supported.
Members
|
Print dialog will offer printing even/odd pages. |
||
|
Print dialog will allow to print multiple copies. |
||
|
Print dialog will allow to collate multiple copies. |
||
|
Print dialog will allow to print pages in reverse order. |
||
|
Print dialog will allow to scale the output. |
||
|
The program will send the document to the printer in PDF format |
||
|
The program will send the document to the printer in Postscript format |
||
|
Print dialog will offer a preview |
||
|
Print dialog will offer printing multiple pages per sheet. Since 2.12 |
||
|
Print dialog will allow to rearrange pages when printing multiple pages per sheet. Since 2.14 |
Property Details
The “current-page” property
“current-page” gint
The current page in the document.
Flags: Read / Write
Allowed values: >= -1
Default value: -1
The “embed-page-setup” property
“embed-page-setup” gboolean
TRUE if page setup combos are embedded in GtkPrintUnixDialog.
Flags: Read / Write
Default value: FALSE
The “has-selection” property
“has-selection” gboolean
Whether the application has a selection.
Flags: Read / Write
Default value: FALSE
The “manual-capabilities” property
“manual-capabilities” GtkPrintCapabilities
Capabilities the application can handle.
Flags: Read / Write
The “print-settings” property
“print-settings” GtkPrintSettings *
The GtkPrintSettings used for initializing the dialog.
Flags: Read / Write
The “selected-printer” property
“selected-printer” GtkPrinter *
The GtkPrinter which is selected.
Flags: Read
The “support-selection” property
“support-selection” gboolean
Whether the dialog supports selection.
Flags: Read / Write
Default value: FALSE