diff --git a/docs/reference/gtk/tmpl/.gitignore b/docs/reference/gtk/tmpl/.gitignore index 5fa9fd4463..5ac6dc17a5 100644 --- a/docs/reference/gtk/tmpl/.gitignore +++ b/docs/reference/gtk/tmpl/.gitignore @@ -30,6 +30,7 @@ gtkmessagedialog.sgml gtknotebook.sgml gtkobject.sgml gtkorientable.sgml +gtkpagesetup.sgml gtkpagesetupunixdialog.sgml gtkpapersize.sgml gtkprinter.sgml diff --git a/docs/reference/gtk/tmpl/gtkpagesetup.sgml b/docs/reference/gtk/tmpl/gtkpagesetup.sgml deleted file mode 100644 index cac99e1421..0000000000 --- a/docs/reference/gtk/tmpl/gtkpagesetup.sgml +++ /dev/null @@ -1,320 +0,0 @@ - -GtkPageSetup - - -Stores page setup information - - - -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. - - -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. - - - - - - - - - - - - - - - - - - - - - - - - -@void: -@Returns: - - - - - - - -@other: -@Returns: - - - - - - - -@setup: -@Returns: - - - - - - - -@setup: -@orientation: - - - - - - - -@setup: -@Returns: - - - - - - - -@setup: -@size: - - - - - - - -@setup: -@unit: -@Returns: - - - - - - - -@setup: -@margin: -@unit: - - - - - - - -@setup: -@unit: -@Returns: - - - - - - - -@setup: -@margin: -@unit: - - - - - - - -@setup: -@unit: -@Returns: - - - - - - - -@setup: -@margin: -@unit: - - - - - - - -@setup: -@unit: -@Returns: - - - - - - - -@setup: -@margin: -@unit: - - - - - - - -@setup: -@size: - - - - - - - -@setup: -@unit: -@Returns: - - - - - - - -@setup: -@unit: -@Returns: - - - - - - - -@setup: -@unit: -@Returns: - - - - - - - -@setup: -@unit: -@Returns: - - - - - - - -@file_name: -@error: -@Returns: - - - - - - - -@key_file: -@group_name: -@error: -@Returns: - - - - - - - -@setup: -@file_name: -@error: -@Returns: - - - - - - - -@setup: -@key_file: -@group_name: -@error: -@Returns: - - - - - - - -@setup: -@file_name: -@error: -@Returns: - - - - - - - -@setup: -@key_file: -@group_name: - - diff --git a/gtk/gtkpagesetup.c b/gtk/gtkpagesetup.c index 8c56a69d25..a00177efd6 100644 --- a/gtk/gtkpagesetup.c +++ b/gtk/gtkpagesetup.c @@ -26,6 +26,58 @@ #include "gtkintl.h" #include "gtktypebuiltins.h" +/** + * SECTION:gtkpagesetup + * @Short_description: Stores page setup information + * @Title: GtkPageSetup + * + * 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. + * + * + * 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. + */ + #define KEYFILE_GROUP_NAME "Page Setup" typedef struct _GtkPageSetupClass GtkPageSetupClass;