<?xml version="1.0"?>
<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
               "http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd" [
<!ENTITY % local.common.attrib "xmlns:xi  CDATA  #FIXED 'http://www.w3.org/2003/XInclude'">
<!ENTITY version SYSTEM "version.xml">
<!ENTITY pi "&#960;">
<!ENTITY solidus "&#8260;">
]>
<refentry id="GtkPageSetup">
<refmeta>
<refentrytitle role="top_of_page" id="GtkPageSetup.top_of_page">GtkPageSetup</refentrytitle>
<manvolnum>3</manvolnum>
<refmiscinfo>GTK4 Library</refmiscinfo>
</refmeta>
<refnamediv>
<refname>GtkPageSetup</refname>
<refpurpose>Stores page setup information</refpurpose>
</refnamediv>

<refsect1 id="GtkPageSetup.functions" role="functions_proto">
<title role="functions_proto.title">Functions</title>
<informaltable pgwide="1" frame="none">
<tgroup cols="2">
<colspec colname="functions_proto_type" colwidth="150px"/>
<colspec colname="functions_proto_name"/>
<tbody>
<row><entry role="function_type"><link linkend="GtkPageSetup"><returnvalue>GtkPageSetup</returnvalue></link>&#160;*
</entry><entry role="function_name"><link linkend="gtk-page-setup-new">gtk_page_setup_new</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="GtkPageSetup"><returnvalue>GtkPageSetup</returnvalue></link>&#160;*
</entry><entry role="function_name"><link linkend="gtk-page-setup-copy">gtk_page_setup_copy</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="GtkPageOrientation"><returnvalue>GtkPageOrientation</returnvalue></link>
</entry><entry role="function_name"><link linkend="gtk-page-setup-get-orientation">gtk_page_setup_get_orientation</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="void"><returnvalue>void</returnvalue></link>
</entry><entry role="function_name"><link linkend="gtk-page-setup-set-orientation">gtk_page_setup_set_orientation</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="GtkPaperSize"><returnvalue>GtkPaperSize</returnvalue></link>&#160;*
</entry><entry role="function_name"><link linkend="gtk-page-setup-get-paper-size">gtk_page_setup_get_paper_size</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="void"><returnvalue>void</returnvalue></link>
</entry><entry role="function_name"><link linkend="gtk-page-setup-set-paper-size">gtk_page_setup_set_paper_size</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="gdouble"><returnvalue>gdouble</returnvalue></link>
</entry><entry role="function_name"><link linkend="gtk-page-setup-get-top-margin">gtk_page_setup_get_top_margin</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="void"><returnvalue>void</returnvalue></link>
</entry><entry role="function_name"><link linkend="gtk-page-setup-set-top-margin">gtk_page_setup_set_top_margin</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="gdouble"><returnvalue>gdouble</returnvalue></link>
</entry><entry role="function_name"><link linkend="gtk-page-setup-get-bottom-margin">gtk_page_setup_get_bottom_margin</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="void"><returnvalue>void</returnvalue></link>
</entry><entry role="function_name"><link linkend="gtk-page-setup-set-bottom-margin">gtk_page_setup_set_bottom_margin</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="gdouble"><returnvalue>gdouble</returnvalue></link>
</entry><entry role="function_name"><link linkend="gtk-page-setup-get-left-margin">gtk_page_setup_get_left_margin</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="void"><returnvalue>void</returnvalue></link>
</entry><entry role="function_name"><link linkend="gtk-page-setup-set-left-margin">gtk_page_setup_set_left_margin</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="gdouble"><returnvalue>gdouble</returnvalue></link>
</entry><entry role="function_name"><link linkend="gtk-page-setup-get-right-margin">gtk_page_setup_get_right_margin</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="void"><returnvalue>void</returnvalue></link>
</entry><entry role="function_name"><link linkend="gtk-page-setup-set-right-margin">gtk_page_setup_set_right_margin</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="void"><returnvalue>void</returnvalue></link>
</entry><entry role="function_name"><link linkend="gtk-page-setup-set-paper-size-and-default-margins">gtk_page_setup_set_paper_size_and_default_margins</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="gdouble"><returnvalue>gdouble</returnvalue></link>
</entry><entry role="function_name"><link linkend="gtk-page-setup-get-paper-width">gtk_page_setup_get_paper_width</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="gdouble"><returnvalue>gdouble</returnvalue></link>
</entry><entry role="function_name"><link linkend="gtk-page-setup-get-paper-height">gtk_page_setup_get_paper_height</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="gdouble"><returnvalue>gdouble</returnvalue></link>
</entry><entry role="function_name"><link linkend="gtk-page-setup-get-page-width">gtk_page_setup_get_page_width</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="gdouble"><returnvalue>gdouble</returnvalue></link>
</entry><entry role="function_name"><link linkend="gtk-page-setup-get-page-height">gtk_page_setup_get_page_height</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>

<row><entry role="function_type"><link linkend="GtkPageSetup"><returnvalue>GtkPageSetup</returnvalue></link>&#160;*
</entry><entry role="function_name"><link linkend="gtk-page-setup-new-from-file">gtk_page_setup_new_from_file</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="GtkPageSetup"><returnvalue>GtkPageSetup</returnvalue></link>&#160;*
</entry><entry role="function_name"><link linkend="gtk-page-setup-new-from-key-file">gtk_page_setup_new_from_key_file</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="GtkPageSetup"><returnvalue>GtkPageSetup</returnvalue></link>&#160;*
</entry><entry role="function_name"><link linkend="gtk-page-setup-new-from-gvariant">gtk_page_setup_new_from_gvariant</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="gboolean"><returnvalue>gboolean</returnvalue></link>
</entry><entry role="function_name"><link linkend="gtk-page-setup-load-file">gtk_page_setup_load_file</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="gboolean"><returnvalue>gboolean</returnvalue></link>
</entry><entry role="function_name"><link linkend="gtk-page-setup-load-key-file">gtk_page_setup_load_key_file</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="gboolean"><returnvalue>gboolean</returnvalue></link>
</entry><entry role="function_name"><link linkend="gtk-page-setup-to-file">gtk_page_setup_to_file</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="void"><returnvalue>void</returnvalue></link>
</entry><entry role="function_name"><link linkend="gtk-page-setup-to-key-file">gtk_page_setup_to_key_file</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="GVariant"><returnvalue>GVariant</returnvalue></link>&#160;*
</entry><entry role="function_name"><link linkend="gtk-page-setup-to-gvariant">gtk_page_setup_to_gvariant</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>

</tbody>
</tgroup>
</informaltable>
</refsect1>
<refsect1 id="GtkPageSetup.other" role="other_proto">
<title role="other_proto.title">Types and Values</title>
<informaltable pgwide="1" frame="none">
<tgroup cols="2">
<colspec colname="other_proto_type" colwidth="150px"/>
<colspec colname="other_proto_name"/>
<tbody>
<row><entry role="datatype_keyword"></entry><entry role="function_name"><link linkend="GtkPageSetup-struct">GtkPageSetup</link></entry></row>

</tbody>
</tgroup>
</informaltable>
</refsect1>
<refsect1 id="GtkPageSetup.object-hierarchy" role="object_hierarchy">
<title role="object_hierarchy.title">Object Hierarchy</title>
<screen>    <link linkend="GObject">GObject</link>
    <phrase role="lineart">&#9584;&#9472;&#9472;</phrase> GtkPageSetup
</screen>
</refsect1>

<refsect1 id="GtkPageSetup.includes"><title>Includes</title><synopsis>#include &lt;gtk/gtk.h&gt;
</synopsis></refsect1>

<refsect1 id="GtkPageSetup.description" role="desc">
<title role="desc.title">Description</title>
<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 <link linkend="GtkPrintOperation"><type>GtkPrintOperation</type></link> when printing.
The benefit of splitting this out of the <link linkend="GtkPrintSettings"><type>GtkPrintSettings</type></link> is that
these affect the actual layout of the page, and thus need to be set
long before user prints.</para>
<refsect3 id="print-margins"><title>Margins</title><para>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.</para>
<para>To obtain a <link linkend="GtkPageSetup"><type>GtkPageSetup</type></link> use <link linkend="gtk-page-setup-new"><function>gtk_page_setup_new()</function></link> to get the defaults,
or use <link linkend="gtk-print-run-page-setup-dialog"><function>gtk_print_run_page_setup_dialog()</function></link> to show the page setup dialog
and receive the resulting page setup.</para>
</refsect3>
<refsect3><title>A page setup dialog</title><informalexample><programlisting role="example"><![CDATA[
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></informalexample>
<para></para>
<para>Printing support was added in GTK+ 2.10.</para>
</refsect3>

</refsect1>
<refsect1 id="GtkPageSetup.functions_details" role="details">
<title role="details.title">Functions</title>
<refsect2 id="gtk-page-setup-new" role="function">
<title>gtk_page_setup_new&#160;()</title>
<indexterm zone="gtk-page-setup-new"><primary>gtk_page_setup_new</primary></indexterm>
<programlisting language="C"><link linkend="GtkPageSetup"><returnvalue>GtkPageSetup</returnvalue></link>&#160;*
gtk_page_setup_new (<parameter><type>void</type></parameter>);</programlisting>
<para>Creates a new <link linkend="GtkPageSetup"><type>GtkPageSetup</type></link>.</para>
<refsect3 id="gtk-page-setup-new.returns" role="returns">
<title>Returns</title>
<para> a new <link linkend="GtkPageSetup"><type>GtkPageSetup</type></link>.</para>
</refsect3></refsect2>
<refsect2 id="gtk-page-setup-copy" role="function">
<title>gtk_page_setup_copy&#160;()</title>
<indexterm zone="gtk-page-setup-copy"><primary>gtk_page_setup_copy</primary></indexterm>
<programlisting language="C"><link linkend="GtkPageSetup"><returnvalue>GtkPageSetup</returnvalue></link>&#160;*
gtk_page_setup_copy (<parameter><link linkend="GtkPageSetup"><type>GtkPageSetup</type></link> *other</parameter>);</programlisting>
<para>Copies a <link linkend="GtkPageSetup"><type>GtkPageSetup</type></link>.</para>
<refsect3 id="gtk-page-setup-copy.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>other</para></entry>
<entry role="parameter_description"><para>the <link linkend="GtkPageSetup"><type>GtkPageSetup</type></link> to copy</para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><refsect3 id="gtk-page-setup-copy.returns" role="returns">
<title>Returns</title>
<para>a copy of <parameter>other</parameter>
. </para>
<para><emphasis role="annotation">[<acronym>transfer full</acronym>]</emphasis></para>
</refsect3></refsect2>
<refsect2 id="gtk-page-setup-get-orientation" role="function">
<title>gtk_page_setup_get_orientation&#160;()</title>
<indexterm zone="gtk-page-setup-get-orientation"><primary>gtk_page_setup_get_orientation</primary></indexterm>
<programlisting language="C"><link linkend="GtkPageOrientation"><returnvalue>GtkPageOrientation</returnvalue></link>
gtk_page_setup_get_orientation (<parameter><link linkend="GtkPageSetup"><type>GtkPageSetup</type></link> *setup</parameter>);</programlisting>
<para>Gets the page orientation of the <link linkend="GtkPageSetup"><type>GtkPageSetup</type></link>.</para>
<refsect3 id="gtk-page-setup-get-orientation.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>setup</para></entry>
<entry role="parameter_description"><para>a <link linkend="GtkPageSetup"><type>GtkPageSetup</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><refsect3 id="gtk-page-setup-get-orientation.returns" role="returns">
<title>Returns</title>
<para> the page orientation</para>
</refsect3></refsect2>
<refsect2 id="gtk-page-setup-set-orientation" role="function">
<title>gtk_page_setup_set_orientation&#160;()</title>
<indexterm zone="gtk-page-setup-set-orientation"><primary>gtk_page_setup_set_orientation</primary></indexterm>
<programlisting language="C"><link linkend="void"><returnvalue>void</returnvalue></link>
gtk_page_setup_set_orientation (<parameter><link linkend="GtkPageSetup"><type>GtkPageSetup</type></link> *setup</parameter>,
                                <parameter><link linkend="GtkPageOrientation"><type>GtkPageOrientation</type></link> orientation</parameter>);</programlisting>
<para>Sets the page orientation of the <link linkend="GtkPageSetup"><type>GtkPageSetup</type></link>.</para>
<refsect3 id="gtk-page-setup-set-orientation.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>setup</para></entry>
<entry role="parameter_description"><para>a <link linkend="GtkPageSetup"><type>GtkPageSetup</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>orientation</para></entry>
<entry role="parameter_description"><para>a <link linkend="GtkPageOrientation"><type>GtkPageOrientation</type></link> value</para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3></refsect2>
<refsect2 id="gtk-page-setup-get-paper-size" role="function">
<title>gtk_page_setup_get_paper_size&#160;()</title>
<indexterm zone="gtk-page-setup-get-paper-size"><primary>gtk_page_setup_get_paper_size</primary></indexterm>
<programlisting language="C"><link linkend="GtkPaperSize"><returnvalue>GtkPaperSize</returnvalue></link>&#160;*
gtk_page_setup_get_paper_size (<parameter><link linkend="GtkPageSetup"><type>GtkPageSetup</type></link> *setup</parameter>);</programlisting>
<para>Gets the paper size of the <link linkend="GtkPageSetup"><type>GtkPageSetup</type></link>.</para>
<refsect3 id="gtk-page-setup-get-paper-size.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>setup</para></entry>
<entry role="parameter_description"><para>a <link linkend="GtkPageSetup"><type>GtkPageSetup</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><refsect3 id="gtk-page-setup-get-paper-size.returns" role="returns">
<title>Returns</title>
<para>the paper size. </para>
<para><emphasis role="annotation">[<acronym>transfer none</acronym>]</emphasis></para>
</refsect3></refsect2>
<refsect2 id="gtk-page-setup-set-paper-size" role="function">
<title>gtk_page_setup_set_paper_size&#160;()</title>
<indexterm zone="gtk-page-setup-set-paper-size"><primary>gtk_page_setup_set_paper_size</primary></indexterm>
<programlisting language="C"><link linkend="void"><returnvalue>void</returnvalue></link>
gtk_page_setup_set_paper_size (<parameter><link linkend="GtkPageSetup"><type>GtkPageSetup</type></link> *setup</parameter>,
                               <parameter><link linkend="GtkPaperSize"><type>GtkPaperSize</type></link> *size</parameter>);</programlisting>
<para>Sets the paper size of the <link linkend="GtkPageSetup"><type>GtkPageSetup</type></link> without
changing the margins. See 
<link linkend="gtk-page-setup-set-paper-size-and-default-margins"><function>gtk_page_setup_set_paper_size_and_default_margins()</function></link>.</para>
<refsect3 id="gtk-page-setup-set-paper-size.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>setup</para></entry>
<entry role="parameter_description"><para>a <link linkend="GtkPageSetup"><type>GtkPageSetup</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>size</para></entry>
<entry role="parameter_description"><para>a <link linkend="GtkPaperSize"><type>GtkPaperSize</type></link> </para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3></refsect2>
<refsect2 id="gtk-page-setup-get-top-margin" role="function">
<title>gtk_page_setup_get_top_margin&#160;()</title>
<indexterm zone="gtk-page-setup-get-top-margin"><primary>gtk_page_setup_get_top_margin</primary></indexterm>
<programlisting language="C"><link linkend="gdouble"><returnvalue>gdouble</returnvalue></link>
gtk_page_setup_get_top_margin (<parameter><link linkend="GtkPageSetup"><type>GtkPageSetup</type></link> *setup</parameter>,
                               <parameter><link linkend="GtkUnit"><type>GtkUnit</type></link> unit</parameter>);</programlisting>
<para>Gets the top margin in units of <parameter>unit</parameter>
.</para>
<refsect3 id="gtk-page-setup-get-top-margin.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>setup</para></entry>
<entry role="parameter_description"><para>a <link linkend="GtkPageSetup"><type>GtkPageSetup</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>unit</para></entry>
<entry role="parameter_description"><para>the unit for the return value</para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><refsect3 id="gtk-page-setup-get-top-margin.returns" role="returns">
<title>Returns</title>
<para> the top margin</para>
</refsect3></refsect2>
<refsect2 id="gtk-page-setup-set-top-margin" role="function">
<title>gtk_page_setup_set_top_margin&#160;()</title>
<indexterm zone="gtk-page-setup-set-top-margin"><primary>gtk_page_setup_set_top_margin</primary></indexterm>
<programlisting language="C"><link linkend="void"><returnvalue>void</returnvalue></link>
gtk_page_setup_set_top_margin (<parameter><link linkend="GtkPageSetup"><type>GtkPageSetup</type></link> *setup</parameter>,
                               <parameter><link linkend="gdouble"><type>gdouble</type></link> margin</parameter>,
                               <parameter><link linkend="GtkUnit"><type>GtkUnit</type></link> unit</parameter>);</programlisting>
<para>Sets the top margin of the <link linkend="GtkPageSetup"><type>GtkPageSetup</type></link>.</para>
<refsect3 id="gtk-page-setup-set-top-margin.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>setup</para></entry>
<entry role="parameter_description"><para>a <link linkend="GtkPageSetup"><type>GtkPageSetup</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>margin</para></entry>
<entry role="parameter_description"><para>the new top margin in units of <parameter>unit</parameter>
</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>unit</para></entry>
<entry role="parameter_description"><para>the units for <parameter>margin</parameter>
</para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3></refsect2>
<refsect2 id="gtk-page-setup-get-bottom-margin" role="function">
<title>gtk_page_setup_get_bottom_margin&#160;()</title>
<indexterm zone="gtk-page-setup-get-bottom-margin"><primary>gtk_page_setup_get_bottom_margin</primary></indexterm>
<programlisting language="C"><link linkend="gdouble"><returnvalue>gdouble</returnvalue></link>
gtk_page_setup_get_bottom_margin (<parameter><link linkend="GtkPageSetup"><type>GtkPageSetup</type></link> *setup</parameter>,
                                  <parameter><link linkend="GtkUnit"><type>GtkUnit</type></link> unit</parameter>);</programlisting>
<para>Gets the bottom margin in units of <parameter>unit</parameter>
.</para>
<refsect3 id="gtk-page-setup-get-bottom-margin.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>setup</para></entry>
<entry role="parameter_description"><para>a <link linkend="GtkPageSetup"><type>GtkPageSetup</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>unit</para></entry>
<entry role="parameter_description"><para>the unit for the return value</para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><refsect3 id="gtk-page-setup-get-bottom-margin.returns" role="returns">
<title>Returns</title>
<para> the bottom margin</para>
</refsect3></refsect2>
<refsect2 id="gtk-page-setup-set-bottom-margin" role="function">
<title>gtk_page_setup_set_bottom_margin&#160;()</title>
<indexterm zone="gtk-page-setup-set-bottom-margin"><primary>gtk_page_setup_set_bottom_margin</primary></indexterm>
<programlisting language="C"><link linkend="void"><returnvalue>void</returnvalue></link>
gtk_page_setup_set_bottom_margin (<parameter><link linkend="GtkPageSetup"><type>GtkPageSetup</type></link> *setup</parameter>,
                                  <parameter><link linkend="gdouble"><type>gdouble</type></link> margin</parameter>,
                                  <parameter><link linkend="GtkUnit"><type>GtkUnit</type></link> unit</parameter>);</programlisting>
<para>Sets the bottom margin of the <link linkend="GtkPageSetup"><type>GtkPageSetup</type></link>.</para>
<refsect3 id="gtk-page-setup-set-bottom-margin.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>setup</para></entry>
<entry role="parameter_description"><para>a <link linkend="GtkPageSetup"><type>GtkPageSetup</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>margin</para></entry>
<entry role="parameter_description"><para>the new bottom margin in units of <parameter>unit</parameter>
</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>unit</para></entry>
<entry role="parameter_description"><para>the units for <parameter>margin</parameter>
</para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3></refsect2>
<refsect2 id="gtk-page-setup-get-left-margin" role="function">
<title>gtk_page_setup_get_left_margin&#160;()</title>
<indexterm zone="gtk-page-setup-get-left-margin"><primary>gtk_page_setup_get_left_margin</primary></indexterm>
<programlisting language="C"><link linkend="gdouble"><returnvalue>gdouble</returnvalue></link>
gtk_page_setup_get_left_margin (<parameter><link linkend="GtkPageSetup"><type>GtkPageSetup</type></link> *setup</parameter>,
                                <parameter><link linkend="GtkUnit"><type>GtkUnit</type></link> unit</parameter>);</programlisting>
<para>Gets the left margin in units of <parameter>unit</parameter>
.</para>
<refsect3 id="gtk-page-setup-get-left-margin.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>setup</para></entry>
<entry role="parameter_description"><para>a <link linkend="GtkPageSetup"><type>GtkPageSetup</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>unit</para></entry>
<entry role="parameter_description"><para>the unit for the return value</para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><refsect3 id="gtk-page-setup-get-left-margin.returns" role="returns">
<title>Returns</title>
<para> the left margin</para>
</refsect3></refsect2>
<refsect2 id="gtk-page-setup-set-left-margin" role="function">
<title>gtk_page_setup_set_left_margin&#160;()</title>
<indexterm zone="gtk-page-setup-set-left-margin"><primary>gtk_page_setup_set_left_margin</primary></indexterm>
<programlisting language="C"><link linkend="void"><returnvalue>void</returnvalue></link>
gtk_page_setup_set_left_margin (<parameter><link linkend="GtkPageSetup"><type>GtkPageSetup</type></link> *setup</parameter>,
                                <parameter><link linkend="gdouble"><type>gdouble</type></link> margin</parameter>,
                                <parameter><link linkend="GtkUnit"><type>GtkUnit</type></link> unit</parameter>);</programlisting>
<para>Sets the left margin of the <link linkend="GtkPageSetup"><type>GtkPageSetup</type></link>.</para>
<refsect3 id="gtk-page-setup-set-left-margin.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>setup</para></entry>
<entry role="parameter_description"><para>a <link linkend="GtkPageSetup"><type>GtkPageSetup</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>margin</para></entry>
<entry role="parameter_description"><para>the new left margin in units of <parameter>unit</parameter>
</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>unit</para></entry>
<entry role="parameter_description"><para>the units for <parameter>margin</parameter>
</para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3></refsect2>
<refsect2 id="gtk-page-setup-get-right-margin" role="function">
<title>gtk_page_setup_get_right_margin&#160;()</title>
<indexterm zone="gtk-page-setup-get-right-margin"><primary>gtk_page_setup_get_right_margin</primary></indexterm>
<programlisting language="C"><link linkend="gdouble"><returnvalue>gdouble</returnvalue></link>
gtk_page_setup_get_right_margin (<parameter><link linkend="GtkPageSetup"><type>GtkPageSetup</type></link> *setup</parameter>,
                                 <parameter><link linkend="GtkUnit"><type>GtkUnit</type></link> unit</parameter>);</programlisting>
<para>Gets the right margin in units of <parameter>unit</parameter>
.</para>
<refsect3 id="gtk-page-setup-get-right-margin.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>setup</para></entry>
<entry role="parameter_description"><para>a <link linkend="GtkPageSetup"><type>GtkPageSetup</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>unit</para></entry>
<entry role="parameter_description"><para>the unit for the return value</para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><refsect3 id="gtk-page-setup-get-right-margin.returns" role="returns">
<title>Returns</title>
<para> the right margin</para>
</refsect3></refsect2>
<refsect2 id="gtk-page-setup-set-right-margin" role="function">
<title>gtk_page_setup_set_right_margin&#160;()</title>
<indexterm zone="gtk-page-setup-set-right-margin"><primary>gtk_page_setup_set_right_margin</primary></indexterm>
<programlisting language="C"><link linkend="void"><returnvalue>void</returnvalue></link>
gtk_page_setup_set_right_margin (<parameter><link linkend="GtkPageSetup"><type>GtkPageSetup</type></link> *setup</parameter>,
                                 <parameter><link linkend="gdouble"><type>gdouble</type></link> margin</parameter>,
                                 <parameter><link linkend="GtkUnit"><type>GtkUnit</type></link> unit</parameter>);</programlisting>
<para>Sets the right margin of the <link linkend="GtkPageSetup"><type>GtkPageSetup</type></link>.</para>
<refsect3 id="gtk-page-setup-set-right-margin.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>setup</para></entry>
<entry role="parameter_description"><para>a <link linkend="GtkPageSetup"><type>GtkPageSetup</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>margin</para></entry>
<entry role="parameter_description"><para>the new right margin in units of <parameter>unit</parameter>
</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>unit</para></entry>
<entry role="parameter_description"><para>the units for <parameter>margin</parameter>
</para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3></refsect2>
<refsect2 id="gtk-page-setup-set-paper-size-and-default-margins" role="function">
<title>gtk_page_setup_set_paper_size_and_default_margins&#160;()</title>
<indexterm zone="gtk-page-setup-set-paper-size-and-default-margins"><primary>gtk_page_setup_set_paper_size_and_default_margins</primary></indexterm>
<programlisting language="C"><link linkend="void"><returnvalue>void</returnvalue></link>
gtk_page_setup_set_paper_size_and_default_margins
                               (<parameter><link linkend="GtkPageSetup"><type>GtkPageSetup</type></link> *setup</parameter>,
                                <parameter><link linkend="GtkPaperSize"><type>GtkPaperSize</type></link> *size</parameter>);</programlisting>
<para>Sets the paper size of the <link linkend="GtkPageSetup"><type>GtkPageSetup</type></link> and modifies
the margins according to the new paper size.</para>
<refsect3 id="gtk-page-setup-set-paper-size-and-default-margins.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>setup</para></entry>
<entry role="parameter_description"><para>a <link linkend="GtkPageSetup"><type>GtkPageSetup</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>size</para></entry>
<entry role="parameter_description"><para>a <link linkend="GtkPaperSize"><type>GtkPaperSize</type></link> </para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3></refsect2>
<refsect2 id="gtk-page-setup-get-paper-width" role="function">
<title>gtk_page_setup_get_paper_width&#160;()</title>
<indexterm zone="gtk-page-setup-get-paper-width"><primary>gtk_page_setup_get_paper_width</primary></indexterm>
<programlisting language="C"><link linkend="gdouble"><returnvalue>gdouble</returnvalue></link>
gtk_page_setup_get_paper_width (<parameter><link linkend="GtkPageSetup"><type>GtkPageSetup</type></link> *setup</parameter>,
                                <parameter><link linkend="GtkUnit"><type>GtkUnit</type></link> unit</parameter>);</programlisting>
<para>Returns the paper width in units of <parameter>unit</parameter>
.</para>
<para>Note that this function takes orientation, but 
not margins into consideration. 
See <link linkend="gtk-page-setup-get-page-width"><function>gtk_page_setup_get_page_width()</function></link>.</para>
<refsect3 id="gtk-page-setup-get-paper-width.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>setup</para></entry>
<entry role="parameter_description"><para>a <link linkend="GtkPageSetup"><type>GtkPageSetup</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>unit</para></entry>
<entry role="parameter_description"><para>the unit for the return value</para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><refsect3 id="gtk-page-setup-get-paper-width.returns" role="returns">
<title>Returns</title>
<para> the paper width.</para>
</refsect3></refsect2>
<refsect2 id="gtk-page-setup-get-paper-height" role="function">
<title>gtk_page_setup_get_paper_height&#160;()</title>
<indexterm zone="gtk-page-setup-get-paper-height"><primary>gtk_page_setup_get_paper_height</primary></indexterm>
<programlisting language="C"><link linkend="gdouble"><returnvalue>gdouble</returnvalue></link>
gtk_page_setup_get_paper_height (<parameter><link linkend="GtkPageSetup"><type>GtkPageSetup</type></link> *setup</parameter>,
                                 <parameter><link linkend="GtkUnit"><type>GtkUnit</type></link> unit</parameter>);</programlisting>
<para>Returns the paper height in units of <parameter>unit</parameter>
.</para>
<para>Note that this function takes orientation, but 
not margins into consideration.
See <link linkend="gtk-page-setup-get-page-height"><function>gtk_page_setup_get_page_height()</function></link>.</para>
<refsect3 id="gtk-page-setup-get-paper-height.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>setup</para></entry>
<entry role="parameter_description"><para>a <link linkend="GtkPageSetup"><type>GtkPageSetup</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>unit</para></entry>
<entry role="parameter_description"><para>the unit for the return value</para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><refsect3 id="gtk-page-setup-get-paper-height.returns" role="returns">
<title>Returns</title>
<para> the paper height.</para>
</refsect3></refsect2>
<refsect2 id="gtk-page-setup-get-page-width" role="function">
<title>gtk_page_setup_get_page_width&#160;()</title>
<indexterm zone="gtk-page-setup-get-page-width"><primary>gtk_page_setup_get_page_width</primary></indexterm>
<programlisting language="C"><link linkend="gdouble"><returnvalue>gdouble</returnvalue></link>
gtk_page_setup_get_page_width (<parameter><link linkend="GtkPageSetup"><type>GtkPageSetup</type></link> *setup</parameter>,
                               <parameter><link linkend="GtkUnit"><type>GtkUnit</type></link> unit</parameter>);</programlisting>
<para>Returns the page width in units of <parameter>unit</parameter>
.</para>
<para>Note that this function takes orientation and
margins into consideration. 
See <link linkend="gtk-page-setup-get-paper-width"><function>gtk_page_setup_get_paper_width()</function></link>.</para>
<refsect3 id="gtk-page-setup-get-page-width.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>setup</para></entry>
<entry role="parameter_description"><para>a <link linkend="GtkPageSetup"><type>GtkPageSetup</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>unit</para></entry>
<entry role="parameter_description"><para>the unit for the return value</para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><refsect3 id="gtk-page-setup-get-page-width.returns" role="returns">
<title>Returns</title>
<para> the page width.</para>
</refsect3></refsect2>
<refsect2 id="gtk-page-setup-get-page-height" role="function">
<title>gtk_page_setup_get_page_height&#160;()</title>
<indexterm zone="gtk-page-setup-get-page-height"><primary>gtk_page_setup_get_page_height</primary></indexterm>
<programlisting language="C"><link linkend="gdouble"><returnvalue>gdouble</returnvalue></link>
gtk_page_setup_get_page_height (<parameter><link linkend="GtkPageSetup"><type>GtkPageSetup</type></link> *setup</parameter>,
                                <parameter><link linkend="GtkUnit"><type>GtkUnit</type></link> unit</parameter>);</programlisting>
<para>Returns the page height in units of <parameter>unit</parameter>
.</para>
<para>Note that this function takes orientation and
margins into consideration. 
See <link linkend="gtk-page-setup-get-paper-height"><function>gtk_page_setup_get_paper_height()</function></link>.</para>
<refsect3 id="gtk-page-setup-get-page-height.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>setup</para></entry>
<entry role="parameter_description"><para>a <link linkend="GtkPageSetup"><type>GtkPageSetup</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>unit</para></entry>
<entry role="parameter_description"><para>the unit for the return value</para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><refsect3 id="gtk-page-setup-get-page-height.returns" role="returns">
<title>Returns</title>
<para> the page height.</para>
</refsect3></refsect2>
<refsect2 id="gtk-page-setup-new-from-file" role="function">
<title>gtk_page_setup_new_from_file&#160;()</title>
<indexterm zone="gtk-page-setup-new-from-file"><primary>gtk_page_setup_new_from_file</primary></indexterm>
<programlisting language="C"><link linkend="GtkPageSetup"><returnvalue>GtkPageSetup</returnvalue></link>&#160;*
gtk_page_setup_new_from_file (<parameter>const <link linkend="gchar"><type>gchar</type></link> *file_name</parameter>,
                              <parameter><link linkend="GError"><type>GError</type></link> **error</parameter>);</programlisting>
<para>Reads the page setup from the file <parameter>file_name</parameter>
. Returns a 
new <link linkend="GtkPageSetup"><type>GtkPageSetup</type></link> object with the restored page setup, 
or <link linkend="NULL:CAPS"><literal>NULL</literal></link> if an error occurred. See <link linkend="gtk-page-setup-to-file"><function>gtk_page_setup_to_file()</function></link>.</para>
<refsect3 id="gtk-page-setup-new-from-file.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>file_name</para></entry>
<entry role="parameter_description"><para>the filename to read the page setup from. </para></entry>
<entry role="parameter_annotations"><emphasis role="annotation">[<acronym>type</acronym> filename]</emphasis></entry></row>
<row><entry role="parameter_name"><para>error</para></entry>
<entry role="parameter_description"><para>return location for an error, or <link linkend="NULL:CAPS"><literal>NULL</literal></link>. </para></entry>
<entry role="parameter_annotations"><emphasis role="annotation">[<acronym>allow-none</acronym>]</emphasis></entry></row>
</tbody></tgroup></informaltable>
</refsect3><refsect3 id="gtk-page-setup-new-from-file.returns" role="returns">
<title>Returns</title>
<para> the restored <link linkend="GtkPageSetup"><type>GtkPageSetup</type></link></para>
</refsect3></refsect2>
<refsect2 id="gtk-page-setup-new-from-key-file" role="function">
<title>gtk_page_setup_new_from_key_file&#160;()</title>
<indexterm zone="gtk-page-setup-new-from-key-file"><primary>gtk_page_setup_new_from_key_file</primary></indexterm>
<programlisting language="C"><link linkend="GtkPageSetup"><returnvalue>GtkPageSetup</returnvalue></link>&#160;*
gtk_page_setup_new_from_key_file (<parameter><link linkend="GKeyFile"><type>GKeyFile</type></link> *key_file</parameter>,
                                  <parameter>const <link linkend="gchar"><type>gchar</type></link> *group_name</parameter>,
                                  <parameter><link linkend="GError"><type>GError</type></link> **error</parameter>);</programlisting>
<para>Reads the page setup from the group <parameter>group_name</parameter>
 in the key file
<parameter>key_file</parameter>
. Returns a new <link linkend="GtkPageSetup"><type>GtkPageSetup</type></link> object with the restored
page setup, or <link linkend="NULL:CAPS"><literal>NULL</literal></link> if an error occurred.</para>
<refsect3 id="gtk-page-setup-new-from-key-file.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>key_file</para></entry>
<entry role="parameter_description"><para>the <link linkend="GKeyFile"><type>GKeyFile</type></link> to retrieve the page_setup from</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>group_name</para></entry>
<entry role="parameter_description"><para>the name of the group in the key_file to read, or <link linkend="NULL:CAPS"><literal>NULL</literal></link>
to use the default name “Page Setup”. </para></entry>
<entry role="parameter_annotations"><emphasis role="annotation">[<acronym>allow-none</acronym>]</emphasis></entry></row>
<row><entry role="parameter_name"><para>error</para></entry>
<entry role="parameter_description"><para>return location for an error, or <link linkend="NULL:CAPS"><literal>NULL</literal></link>. </para></entry>
<entry role="parameter_annotations"><emphasis role="annotation">[<acronym>allow-none</acronym>]</emphasis></entry></row>
</tbody></tgroup></informaltable>
</refsect3><refsect3 id="gtk-page-setup-new-from-key-file.returns" role="returns">
<title>Returns</title>
<para> the restored <link linkend="GtkPageSetup"><type>GtkPageSetup</type></link></para>
</refsect3></refsect2>
<refsect2 id="gtk-page-setup-new-from-gvariant" role="function">
<title>gtk_page_setup_new_from_gvariant&#160;()</title>
<indexterm zone="gtk-page-setup-new-from-gvariant"><primary>gtk_page_setup_new_from_gvariant</primary></indexterm>
<programlisting language="C"><link linkend="GtkPageSetup"><returnvalue>GtkPageSetup</returnvalue></link>&#160;*
gtk_page_setup_new_from_gvariant (<parameter><link linkend="GVariant"><type>GVariant</type></link> *variant</parameter>);</programlisting>
<para>Desrialize a page setup from an a{sv} variant in
the format produced by <link linkend="gtk-page-setup-to-gvariant"><function>gtk_page_setup_to_gvariant()</function></link>.</para>
<refsect3 id="gtk-page-setup-new-from-gvariant.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>variant</para></entry>
<entry role="parameter_description"><para>an a{sv} <link linkend="GVariant"><type>GVariant</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><refsect3 id="gtk-page-setup-new-from-gvariant.returns" role="returns">
<title>Returns</title>
<para>a new <link linkend="GtkPageSetup"><type>GtkPageSetup</type></link> object. </para>
<para><emphasis role="annotation">[<acronym>transfer full</acronym>]</emphasis></para>
</refsect3></refsect2>
<refsect2 id="gtk-page-setup-load-file" role="function">
<title>gtk_page_setup_load_file&#160;()</title>
<indexterm zone="gtk-page-setup-load-file"><primary>gtk_page_setup_load_file</primary></indexterm>
<programlisting language="C"><link linkend="gboolean"><returnvalue>gboolean</returnvalue></link>
gtk_page_setup_load_file (<parameter><link linkend="GtkPageSetup"><type>GtkPageSetup</type></link> *setup</parameter>,
                          <parameter>const <link linkend="char"><type>char</type></link> *file_name</parameter>,
                          <parameter><link linkend="GError"><type>GError</type></link> **error</parameter>);</programlisting>
<para>Reads the page setup from the file <parameter>file_name</parameter>
.
See <link linkend="gtk-page-setup-to-file"><function>gtk_page_setup_to_file()</function></link>.</para>
<refsect3 id="gtk-page-setup-load-file.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>setup</para></entry>
<entry role="parameter_description"><para>a <link linkend="GtkPageSetup"><type>GtkPageSetup</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>file_name</para></entry>
<entry role="parameter_description"><para>the filename to read the page setup from. </para></entry>
<entry role="parameter_annotations"><emphasis role="annotation">[<acronym>type</acronym> filename]</emphasis></entry></row>
<row><entry role="parameter_name"><para>error</para></entry>
<entry role="parameter_description"><para>return location for an error, or <link linkend="NULL:CAPS"><literal>NULL</literal></link>. </para></entry>
<entry role="parameter_annotations"><emphasis role="annotation">[<acronym>allow-none</acronym>]</emphasis></entry></row>
</tbody></tgroup></informaltable>
</refsect3><refsect3 id="gtk-page-setup-load-file.returns" role="returns">
<title>Returns</title>
<para> <link linkend="TRUE:CAPS"><literal>TRUE</literal></link> on success</para>
</refsect3></refsect2>
<refsect2 id="gtk-page-setup-load-key-file" role="function">
<title>gtk_page_setup_load_key_file&#160;()</title>
<indexterm zone="gtk-page-setup-load-key-file"><primary>gtk_page_setup_load_key_file</primary></indexterm>
<programlisting language="C"><link linkend="gboolean"><returnvalue>gboolean</returnvalue></link>
gtk_page_setup_load_key_file (<parameter><link linkend="GtkPageSetup"><type>GtkPageSetup</type></link> *setup</parameter>,
                              <parameter><link linkend="GKeyFile"><type>GKeyFile</type></link> *key_file</parameter>,
                              <parameter>const <link linkend="gchar"><type>gchar</type></link> *group_name</parameter>,
                              <parameter><link linkend="GError"><type>GError</type></link> **error</parameter>);</programlisting>
<para>Reads the page setup from the group <parameter>group_name</parameter>
 in the key file
<parameter>key_file</parameter>
.</para>
<refsect3 id="gtk-page-setup-load-key-file.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>setup</para></entry>
<entry role="parameter_description"><para>a <link linkend="GtkPageSetup"><type>GtkPageSetup</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>key_file</para></entry>
<entry role="parameter_description"><para>the <link linkend="GKeyFile"><type>GKeyFile</type></link> to retrieve the page_setup from</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>group_name</para></entry>
<entry role="parameter_description"><para>the name of the group in the key_file to read, or <link linkend="NULL:CAPS"><literal>NULL</literal></link>
to use the default name “Page Setup”. </para></entry>
<entry role="parameter_annotations"><emphasis role="annotation">[<acronym>allow-none</acronym>]</emphasis></entry></row>
<row><entry role="parameter_name"><para>error</para></entry>
<entry role="parameter_description"><para>return location for an error, or <link linkend="NULL:CAPS"><literal>NULL</literal></link>. </para></entry>
<entry role="parameter_annotations"><emphasis role="annotation">[<acronym>allow-none</acronym>]</emphasis></entry></row>
</tbody></tgroup></informaltable>
</refsect3><refsect3 id="gtk-page-setup-load-key-file.returns" role="returns">
<title>Returns</title>
<para> <link linkend="TRUE:CAPS"><literal>TRUE</literal></link> on success</para>
</refsect3></refsect2>
<refsect2 id="gtk-page-setup-to-file" role="function">
<title>gtk_page_setup_to_file&#160;()</title>
<indexterm zone="gtk-page-setup-to-file"><primary>gtk_page_setup_to_file</primary></indexterm>
<programlisting language="C"><link linkend="gboolean"><returnvalue>gboolean</returnvalue></link>
gtk_page_setup_to_file (<parameter><link linkend="GtkPageSetup"><type>GtkPageSetup</type></link> *setup</parameter>,
                        <parameter>const <link linkend="char"><type>char</type></link> *file_name</parameter>,
                        <parameter><link linkend="GError"><type>GError</type></link> **error</parameter>);</programlisting>
<para>This function saves the information from <parameter>setup</parameter>
 to <parameter>file_name</parameter>
.</para>
<refsect3 id="gtk-page-setup-to-file.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>setup</para></entry>
<entry role="parameter_description"><para>a <link linkend="GtkPageSetup"><type>GtkPageSetup</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>file_name</para></entry>
<entry role="parameter_description"><para>the file to save to. </para></entry>
<entry role="parameter_annotations"><emphasis role="annotation">[<acronym>type</acronym> filename]</emphasis></entry></row>
<row><entry role="parameter_name"><para>error</para></entry>
<entry role="parameter_description"><para>return location for errors, or <link linkend="NULL:CAPS"><literal>NULL</literal></link>. </para></entry>
<entry role="parameter_annotations"><emphasis role="annotation">[<acronym>allow-none</acronym>]</emphasis></entry></row>
</tbody></tgroup></informaltable>
</refsect3><refsect3 id="gtk-page-setup-to-file.returns" role="returns">
<title>Returns</title>
<para> <link linkend="TRUE:CAPS"><literal>TRUE</literal></link> on success</para>
</refsect3></refsect2>
<refsect2 id="gtk-page-setup-to-key-file" role="function">
<title>gtk_page_setup_to_key_file&#160;()</title>
<indexterm zone="gtk-page-setup-to-key-file"><primary>gtk_page_setup_to_key_file</primary></indexterm>
<programlisting language="C"><link linkend="void"><returnvalue>void</returnvalue></link>
gtk_page_setup_to_key_file (<parameter><link linkend="GtkPageSetup"><type>GtkPageSetup</type></link> *setup</parameter>,
                            <parameter><link linkend="GKeyFile"><type>GKeyFile</type></link> *key_file</parameter>,
                            <parameter>const <link linkend="gchar"><type>gchar</type></link> *group_name</parameter>);</programlisting>
<para>This function adds the page setup from <parameter>setup</parameter>
 to <parameter>key_file</parameter>
.</para>
<refsect3 id="gtk-page-setup-to-key-file.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>setup</para></entry>
<entry role="parameter_description"><para>a <link linkend="GtkPageSetup"><type>GtkPageSetup</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>key_file</para></entry>
<entry role="parameter_description"><para>the <link linkend="GKeyFile"><type>GKeyFile</type></link> to save the page setup to</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>group_name</para></entry>
<entry role="parameter_description"><para>the group to add the settings to in <parameter>key_file</parameter>
,
or <link linkend="NULL:CAPS"><literal>NULL</literal></link> to use the default name “Page Setup”. </para></entry>
<entry role="parameter_annotations"><emphasis role="annotation">[<acronym>nullable</acronym>]</emphasis></entry></row>
</tbody></tgroup></informaltable>
</refsect3></refsect2>
<refsect2 id="gtk-page-setup-to-gvariant" role="function">
<title>gtk_page_setup_to_gvariant&#160;()</title>
<indexterm zone="gtk-page-setup-to-gvariant"><primary>gtk_page_setup_to_gvariant</primary></indexterm>
<programlisting language="C"><link linkend="GVariant"><returnvalue>GVariant</returnvalue></link>&#160;*
gtk_page_setup_to_gvariant (<parameter><link linkend="GtkPageSetup"><type>GtkPageSetup</type></link> *setup</parameter>);</programlisting>
<para>Serialize page setup to an a{sv} variant.</para>
<para>Return: (transfer none): a new, floating, <link linkend="GVariant"><type>GVariant</type></link></para>
<refsect3 id="gtk-page-setup-to-gvariant.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>setup</para></entry>
<entry role="parameter_description"><para>a <link linkend="GtkPageSetup"><type>GtkPageSetup</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3></refsect2>

</refsect1>
<refsect1 id="GtkPageSetup.other_details" role="details">
<title role="details.title">Types and Values</title>
<refsect2 id="GtkPageSetup-struct" role="struct">
<title>GtkPageSetup</title>
<indexterm zone="GtkPageSetup-struct"><primary>GtkPageSetup</primary></indexterm>
<programlisting language="C">typedef struct _GtkPageSetup GtkPageSetup;</programlisting>
</refsect2>

</refsect1>

</refentry>
