Class

GtkPageSetup

Description [src]

final class Gtk.PageSetup : GObject.Object
{
  /* No available fields */
}

A GtkPageSetup object stores the page size, orientation and margins. The idea is that you can get one of these from the page setup dialog and then pass it to the GtkPrintOperation when printing. The benefit of splitting this out of the GtkPrintSettings is that these affect the actual layout of the page, and thus need to be set long before user prints.

Margins ## {#print-margins}

The margins specified in this object are the “print margins”, i.e. the parts of the page that the printer cannot print on. These are different from the layout margins that a word processor uses; they are typically used to determine the minimal size for the layout margins.

To obtain a GtkPageSetup use gtk_page_setup_new() to get the defaults, or use gtk_print_run_page_setup_dialog() to show the page setup dialog and receive the resulting page setup.

A page setup dialog

static GtkPrintSettings *settings = NULL;
static GtkPageSetup *page_setup = NULL;

static void
do_page_setup (void)
{
  GtkPageSetup *new_page_setup;

  if (settings == NULL)
    settings = gtk_print_settings_new ();

  new_page_setup = gtk_print_run_page_setup_dialog (GTK_WINDOW (main_window),
                                                    page_setup, settings);

  if (page_setup)
    g_object_unref (page_setup);

  page_setup = new_page_setup;
}

Printing support was added in GTK+ 2.10.

Hierarchy

Ancestors

GObject

Constructors

gtk_page_setup_new

Creates a new GtkPageSetup.

since: 2.10

gtk_page_setup_new_from_file

Reads the page setup from the file file_name. Returns a new GtkPageSetup object with the restored page setup, or NULL if an error occurred. See gtk_page_setup_to_file().

since: 2.12

gtk_page_setup_new_from_gvariant

Desrialize a page setup from an a{sv} variant in the format produced by gtk_page_setup_to_gvariant().

since: 3.22

gtk_page_setup_new_from_key_file

Reads the page setup from the group group_name in the key file key_file. Returns a new GtkPageSetup object with the restored page setup, or NULL if an error occurred.

since: 2.12