GtkPrintUnixDialog: GTK+ 2 Reference Manual

## GtkPrintUnixDialog GtkPrintUnixDialog |

## Functions

GtkWidget * | gtk_print_unix_dialog_new ()
void | gtk_print_unix_dialog_set_page_setup ()
GtkPageSetup * | gtk_print_unix_dialog_get_page_setup ()
void | gtk_print_unix_dialog_set_current_page ()
gint | gtk_print_unix_dialog_get_current_page ()
void | gtk_print_unix_dialog_set_settings ()
GtkPrintSettings * | gtk_print_unix_dialog_get_settings ()
GtkPrinter * | gtk_print_unix_dialog_get_selected_printer ()
void | gtk_print_unix_dialog_add_custom_tab ()
void | gtk_print_unix_dialog_set_support_selection ()
gboolean | gtk_print_unix_dialog_get_support_selection ()
void | gtk_print_unix_dialog_set_has_selection ()
gboolean | gtk_print_unix_dialog_get_has_selection ()
void | gtk_print_unix_dialog_set_embed_page_setup ()
gboolean | gtk_print_unix_dialog_get_embed_page_setup ()
gboolean | gtk_print_unix_dialog_get_page_setup_set ()
void | gtk_print_unix_dialog_set_manual_capabilities ()
GtkPrintCapabilities | gtk_print_unix_dialog_get_manual_capabilities ()

## Properties

int | 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

## Types and Values

struct | GtkPrintUnixDialog
enum | GtkPrintCapabilities

## Object Hierarchy

        GObject
        ╰── GInitiallyUnowned
            ╰── GtkObject
                ╰── GtkWidget
                    ╰── GtkContainer
                        ╰── GtkBin
                            ╰── GtkWindow
                                ╰── GtkDialog
                                    ╰── GtkPrintUnixDialog

## Implemented Interfaces

GtkPrintUnixDialog implements AtkImplementorIface and GtkBuildable.

## Includes

    #include <gtk/gtkprintunixdialog.h>

## Description

## Functions

### gtk_print_unix_dialog_new ()

    GtkWidget *
    gtk_print_unix_dialog_new (const gchar *title,
                               GtkWindow *parent);

Creates a new GtkPrintUnixDialog.

#### Parameters

title | Title of the dialog, or `NULL`. | [allow-none]
parent | Transient parent of the dialog, or `NULL`. | [allow-none]

#### Returns

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.

#### Parameters

dialog | a GtkPrintUnixDialog |
page_setup | a GtkPageSetup |

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.

#### Parameters

dialog | a 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.

#### Parameters

dialog | a GtkPrintUnixDialog |
current_page | the current page number. |

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.

#### Parameters

dialog | a GtkPrintUnixDialog |

#### Returns

the current page of `dialog`

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.

#### Parameters

dialog | a GtkPrintUnixDialog |
settings | a GtkPrintSettings, or `NULL`. | [allow-none]

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.

#### Parameters

dialog | a GtkPrintUnixDialog |

#### Returns

a new GtkPrintSettings object with the values from `dialog`

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.

#### Parameters

dialog | a GtkPrintUnixDialog |

#### 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.

#### Parameters

dialog | a GtkPrintUnixDialog |
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.

#### Parameters

dialog | a GtkPrintUnixDialog |
support_selection | `TRUE` to allow print 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.

#### Parameters

dialog | a GtkPrintUnixDialog |

#### 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.

#### Parameters

dialog | a GtkPrintUnixDialog |
has_selection | `TRUE` indicates that 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.

#### Parameters

dialog | a GtkPrintUnixDialog |

#### 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.

#### Parameters

dialog | a GtkPrintUnixDialog |
embed | embed page setup selection |

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.

#### Parameters

dialog | a GtkPrintUnixDialog |

#### 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.

#### Parameters

dialog | a 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.

#### Parameters

dialog | a GtkPrintUnixDialog |
capabilities | the printing capabilities of your application |

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.

#### Parameters

dialog | a GtkPrintUnixDialog |

#### Returns

the printing capabilities

Since: 2.18

## Types and Values

### struct GtkPrintUnixDialog

    struct GtkPrintUnixDialog;

### enum GtkPrintCapabilities

#### Members

GTK_PRINT_CAPABILITY_PAGE_SET |  |
GTK_PRINT_CAPABILITY_COPIES |  |
GTK_PRINT_CAPABILITY_COLLATE |  |
GTK_PRINT_CAPABILITY_REVERSE |  |
GTK_PRINT_CAPABILITY_SCALE |  |
GTK_PRINT_CAPABILITY_GENERATE_PDF |  |
GTK_PRINT_CAPABILITY_GENERATE_PS |  |
GTK_PRINT_CAPABILITY_PREVIEW |  |
GTK_PRINT_CAPABILITY_NUMBER_UP |  |
GTK_PRINT_CAPABILITY_NUMBER_UP_LAYOUT |  |

## Property Details

### The `“current-page”` property

      “current-page”             int

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