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:
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”.
An example of a GtkPrintUnixDialog UI definition fragment:
CSS nodes
GtkPrintUnixDialog has a single CSS node with name printdialog.
Functions
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.
Returns
the page setup of dialog
.
[transfer none]
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 GtkPrintUnixDialog.
Returns
the current page of dialog
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.
Returns
the currently selected printer.
[transfer none]
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.
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.
Returns
whether the application supports print of selection
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.
Returns
whether there is a selection
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.
Returns
whether there is a selection
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.
Returns
whether a page setup was set by user.
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
Property Details
The “current-page” property
“current-page” gint
The current page in the document.
Owner: GtkPrintUnixDialog
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.
Owner: GtkPrintUnixDialog
Flags: Read / Write
Default value: FALSE
The “has-selection” property
“has-selection” gboolean
Whether the application has a selection.
Owner: GtkPrintUnixDialog
Flags: Read / Write
Default value: FALSE
The “manual-capabilities” property
“manual-capabilities” GtkPrintCapabilities
Capabilities the application can handle.
Owner: GtkPrintUnixDialog
Flags: Read / Write
The “page-setup” property
“page-setup” GtkPageSetup *
The GtkPageSetup to use.
Owner: GtkPrintUnixDialog
Flags: Read / Write
The “print-settings” property
“print-settings” GtkPrintSettings *
The GtkPrintSettings used for initializing the dialog.
Owner: GtkPrintUnixDialog
Flags: Read / Write
The “selected-printer” property
“selected-printer” GtkPrinter *
The GtkPrinter which is selected.
Owner: GtkPrintUnixDialog
Flags: Read
The “support-selection” property
“support-selection” gboolean
Whether the dialog supports selection.
Owner: GtkPrintUnixDialog
Flags: Read / Write
Default value: FALSE