forked from AuroraMiddleware/gtk
252 lines
3.7 KiB
Plaintext
252 lines
3.7 KiB
Plaintext
<!-- ##### SECTION Title ##### -->
|
|
GtkPageSetup
|
|
|
|
<!-- ##### SECTION Short_Description ##### -->
|
|
Stores page setup information
|
|
|
|
<!-- ##### SECTION Long_Description ##### -->
|
|
<para>
|
|
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.
|
|
</para>
|
|
<para id="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 <emphasis>minimal</emphasis> size for the layout
|
|
margins.
|
|
</para>
|
|
<para>
|
|
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.
|
|
</para>
|
|
<example>
|
|
<title>A page setup dialog</title>
|
|
<programlisting>
|
|
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;
|
|
}
|
|
</programlisting>
|
|
</example>
|
|
<para>
|
|
Printing support was added in GTK+ 2.10.
|
|
</para>
|
|
|
|
<!-- ##### SECTION See_Also ##### -->
|
|
<para>
|
|
|
|
</para>
|
|
|
|
<!-- ##### SECTION Stability_Level ##### -->
|
|
|
|
|
|
<!-- ##### STRUCT GtkPageSetup ##### -->
|
|
<para>
|
|
|
|
</para>
|
|
|
|
|
|
<!-- ##### FUNCTION gtk_page_setup_new ##### -->
|
|
<para>
|
|
|
|
</para>
|
|
|
|
@Returns:
|
|
|
|
|
|
<!-- ##### FUNCTION gtk_page_setup_copy ##### -->
|
|
<para>
|
|
|
|
</para>
|
|
|
|
@other:
|
|
@Returns:
|
|
|
|
|
|
<!-- ##### FUNCTION gtk_page_setup_get_orientation ##### -->
|
|
<para>
|
|
|
|
</para>
|
|
|
|
@setup:
|
|
@Returns:
|
|
|
|
|
|
<!-- ##### FUNCTION gtk_page_setup_set_orientation ##### -->
|
|
<para>
|
|
|
|
</para>
|
|
|
|
@setup:
|
|
@orientation:
|
|
|
|
|
|
<!-- ##### FUNCTION gtk_page_setup_get_paper_size ##### -->
|
|
<para>
|
|
|
|
</para>
|
|
|
|
@setup:
|
|
@Returns:
|
|
|
|
|
|
<!-- ##### FUNCTION gtk_page_setup_set_paper_size ##### -->
|
|
<para>
|
|
|
|
</para>
|
|
|
|
@setup:
|
|
@size:
|
|
|
|
|
|
<!-- ##### FUNCTION gtk_page_setup_get_top_margin ##### -->
|
|
<para>
|
|
|
|
</para>
|
|
|
|
@setup:
|
|
@unit:
|
|
@Returns:
|
|
|
|
|
|
<!-- ##### FUNCTION gtk_page_setup_set_top_margin ##### -->
|
|
<para>
|
|
|
|
</para>
|
|
|
|
@setup:
|
|
@margin:
|
|
@unit:
|
|
|
|
|
|
<!-- ##### FUNCTION gtk_page_setup_get_bottom_margin ##### -->
|
|
<para>
|
|
|
|
</para>
|
|
|
|
@setup:
|
|
@unit:
|
|
@Returns:
|
|
|
|
|
|
<!-- ##### FUNCTION gtk_page_setup_set_bottom_margin ##### -->
|
|
<para>
|
|
|
|
</para>
|
|
|
|
@setup:
|
|
@margin:
|
|
@unit:
|
|
|
|
|
|
<!-- ##### FUNCTION gtk_page_setup_get_left_margin ##### -->
|
|
<para>
|
|
|
|
</para>
|
|
|
|
@setup:
|
|
@unit:
|
|
@Returns:
|
|
|
|
|
|
<!-- ##### FUNCTION gtk_page_setup_set_left_margin ##### -->
|
|
<para>
|
|
|
|
</para>
|
|
|
|
@setup:
|
|
@margin:
|
|
@unit:
|
|
|
|
|
|
<!-- ##### FUNCTION gtk_page_setup_get_right_margin ##### -->
|
|
<para>
|
|
|
|
</para>
|
|
|
|
@setup:
|
|
@unit:
|
|
@Returns:
|
|
|
|
|
|
<!-- ##### FUNCTION gtk_page_setup_set_right_margin ##### -->
|
|
<para>
|
|
|
|
</para>
|
|
|
|
@setup:
|
|
@margin:
|
|
@unit:
|
|
|
|
|
|
<!-- ##### FUNCTION gtk_page_setup_set_paper_size_and_default_margins ##### -->
|
|
<para>
|
|
|
|
</para>
|
|
|
|
@setup:
|
|
@size:
|
|
|
|
|
|
<!-- ##### FUNCTION gtk_page_setup_get_paper_width ##### -->
|
|
<para>
|
|
|
|
</para>
|
|
|
|
@setup:
|
|
@unit:
|
|
@Returns:
|
|
|
|
|
|
<!-- ##### FUNCTION gtk_page_setup_get_paper_height ##### -->
|
|
<para>
|
|
|
|
</para>
|
|
|
|
@setup:
|
|
@unit:
|
|
@Returns:
|
|
|
|
|
|
<!-- ##### FUNCTION gtk_page_setup_get_page_width ##### -->
|
|
<para>
|
|
|
|
</para>
|
|
|
|
@setup:
|
|
@unit:
|
|
@Returns:
|
|
|
|
|
|
<!-- ##### FUNCTION gtk_page_setup_get_page_height ##### -->
|
|
<para>
|
|
|
|
</para>
|
|
|
|
@setup:
|
|
@unit:
|
|
@Returns:
|
|
|
|
|