1
<refentry id="GtkPageSetupUnixDialog">
3
<refentrytitle role="top_of_page">GtkPageSetupUnixDialog</refentrytitle>
4
<manvolnum>3</manvolnum>
5
<refmiscinfo>GTK Library</refmiscinfo>
9
<refname>GtkPageSetupUnixDialog</refname>
10
<refpurpose>A page setup dialog</refpurpose>
11
<!--[<xref linkend="desc" endterm="desc.title"/>]-->
14
<refsynopsisdiv role="synopsis">
15
<title role="synopsis.title">Synopsis</title>
19
#include <gtk/gtkpagesetupunixdialog.h>
22
<link linkend="GtkPageSetupUnixDialog-struct">GtkPageSetupUnixDialog</link>;
23
<link linkend="GtkWidget">GtkWidget</link>* <link linkend="gtk-page-setup-unix-dialog-new">gtk_page_setup_unix_dialog_new</link> (const <link linkend="gchar">gchar</link> *title,
24
<link linkend="GtkWindow">GtkWindow</link> *parent);
25
<link linkend="void">void</link> <link linkend="gtk-page-setup-unix-dialog-set-page-setup">gtk_page_setup_unix_dialog_set_page_setup</link>
26
(<link linkend="GtkPageSetupUnixDialog">GtkPageSetupUnixDialog</link> *dialog,
27
<link linkend="GtkPageSetup">GtkPageSetup</link> *page_setup);
28
<link linkend="GtkPageSetup">GtkPageSetup</link>* <link linkend="gtk-page-setup-unix-dialog-get-page-setup">gtk_page_setup_unix_dialog_get_page_setup</link>
29
(<link linkend="GtkPageSetupUnixDialog">GtkPageSetupUnixDialog</link> *dialog);
30
<link linkend="void">void</link> <link linkend="gtk-page-setup-unix-dialog-set-print-settings">gtk_page_setup_unix_dialog_set_print_settings</link>
31
(<link linkend="GtkPageSetupUnixDialog">GtkPageSetupUnixDialog</link> *dialog,
32
<link linkend="GtkPrintSettings">GtkPrintSettings</link> *print_settings);
33
<link linkend="GtkPrintSettings">GtkPrintSettings</link>* <link linkend="gtk-page-setup-unix-dialog-get-print-settings">gtk_page_setup_unix_dialog_get_print_settings</link>
34
(<link linkend="GtkPageSetupUnixDialog">GtkPageSetupUnixDialog</link> *dialog);
40
<refsect1 role="object_hierarchy">
41
<title role="object_hierarchy.title">Object Hierarchy</title>
44
<link linkend="GObject">GObject</link>
45
+----<link linkend="GInitiallyUnowned">GInitiallyUnowned</link>
46
+----<link linkend="GtkObject">GtkObject</link>
47
+----<link linkend="GtkWidget">GtkWidget</link>
48
+----<link linkend="GtkContainer">GtkContainer</link>
49
+----<link linkend="GtkBin">GtkBin</link>
50
+----<link linkend="GtkWindow">GtkWindow</link>
51
+----<link linkend="GtkDialog">GtkDialog</link>
52
+----GtkPageSetupUnixDialog
59
<refsect1 role="impl_interfaces">
60
<title role="impl_interfaces.title">Implemented Interfaces</title>
62
GtkPageSetupUnixDialog implements
63
<link linkend="AtkImplementorIface">AtkImplementorIface</link>.</para>
71
<refsect1 role="desc">
72
<title role="desc.title">Description</title>
74
GtkPageSetupUnixDialog implements a page setup dialog for platforms
75
which don't provide a native page setup dialog, like Unix. It can
76
be used very much like any other GTK+ dialog, at the cost of
77
the portability offered by the <link
78
linkend="gtk-High-level-Printing-API">high-level printing API</link>
82
Printing support was added in GTK+ 2.10.
86
<refsect1 role="details">
87
<title role="details.title">Details</title>
89
<title><anchor id="GtkPageSetupUnixDialog-struct" role="struct"/>GtkPageSetupUnixDialog</title>
90
<indexterm><primary>GtkPageSetupUnixDialog</primary></indexterm><programlisting>typedef struct _GtkPageSetupUnixDialog GtkPageSetupUnixDialog;</programlisting>
95
<title><anchor id="gtk-page-setup-unix-dialog-new" role="function" condition="since:2.10"/>gtk_page_setup_unix_dialog_new ()</title>
96
<indexterm role="2.10"><primary>gtk_page_setup_unix_dialog_new</primary></indexterm><programlisting><link linkend="GtkWidget">GtkWidget</link>* gtk_page_setup_unix_dialog_new (const <link linkend="gchar">gchar</link> *title,
97
<link linkend="GtkWindow">GtkWindow</link> *parent);</programlisting>
99
Creates a new page setup dialog.</para>
102
</para><variablelist role="params">
103
<varlistentry><term><parameter>title</parameter> :</term>
104
<listitem><simpara> the title of the dialog, or <link linkend="NULL:CAPS"><literal>NULL</literal></link>
105
</simpara></listitem></varlistentry>
106
<varlistentry><term><parameter>parent</parameter> :</term>
107
<listitem><simpara> transient parent of the dialog, or <link linkend="NULL:CAPS"><literal>NULL</literal></link>
108
</simpara></listitem></varlistentry>
109
<varlistentry><term><emphasis>Returns</emphasis> :</term><listitem><simpara> the new <link linkend="GtkPageSetupUnixDialog"><type>GtkPageSetupUnixDialog</type></link>
111
</simpara></listitem></varlistentry>
112
</variablelist><para role="since">Since 2.10
115
<title><anchor id="gtk-page-setup-unix-dialog-set-page-setup" role="function" condition="since:2.10"/>gtk_page_setup_unix_dialog_set_page_setup ()</title>
116
<indexterm role="2.10"><primary>gtk_page_setup_unix_dialog_set_page_setup</primary></indexterm><programlisting><link linkend="void">void</link> gtk_page_setup_unix_dialog_set_page_setup
117
(<link linkend="GtkPageSetupUnixDialog">GtkPageSetupUnixDialog</link> *dialog,
118
<link linkend="GtkPageSetup">GtkPageSetup</link> *page_setup);</programlisting>
120
Sets the <link linkend="GtkPageSetup"><type>GtkPageSetup</type></link> from which the page setup
121
dialog takes its values.</para>
124
</para><variablelist role="params">
125
<varlistentry><term><parameter>dialog</parameter> :</term>
126
<listitem><simpara> a <link linkend="GtkPageSetupUnixDialog"><type>GtkPageSetupUnixDialog</type></link>
127
</simpara></listitem></varlistentry>
128
<varlistentry><term><parameter>page_setup</parameter> :</term>
129
<listitem><simpara> a <link linkend="GtkPageSetup"><type>GtkPageSetup</type></link>
130
</simpara></listitem></varlistentry>
131
</variablelist><para role="since">Since 2.10
134
<title><anchor id="gtk-page-setup-unix-dialog-get-page-setup" role="function" condition="since:2.10"/>gtk_page_setup_unix_dialog_get_page_setup ()</title>
135
<indexterm role="2.10"><primary>gtk_page_setup_unix_dialog_get_page_setup</primary></indexterm><programlisting><link linkend="GtkPageSetup">GtkPageSetup</link>* gtk_page_setup_unix_dialog_get_page_setup
136
(<link linkend="GtkPageSetupUnixDialog">GtkPageSetupUnixDialog</link> *dialog);</programlisting>
138
Gets the currently selected page setup from the dialog.</para>
141
</para><variablelist role="params">
142
<varlistentry><term><parameter>dialog</parameter> :</term>
143
<listitem><simpara> a <link linkend="GtkPageSetupUnixDialog"><type>GtkPageSetupUnixDialog</type></link>
144
</simpara></listitem></varlistentry>
145
<varlistentry><term><emphasis>Returns</emphasis> :</term><listitem><simpara> the current page setup
147
</simpara></listitem></varlistentry>
148
</variablelist><para role="since">Since 2.10
151
<title><anchor id="gtk-page-setup-unix-dialog-set-print-settings" role="function" condition="since:2.10"/>gtk_page_setup_unix_dialog_set_print_settings ()</title>
152
<indexterm role="2.10"><primary>gtk_page_setup_unix_dialog_set_print_settings</primary></indexterm><programlisting><link linkend="void">void</link> gtk_page_setup_unix_dialog_set_print_settings
153
(<link linkend="GtkPageSetupUnixDialog">GtkPageSetupUnixDialog</link> *dialog,
154
<link linkend="GtkPrintSettings">GtkPrintSettings</link> *print_settings);</programlisting>
156
Sets the <link linkend="GtkPrintSettings"><type>GtkPrintSettings</type></link> from which the page setup dialog
157
takes its values.</para>
160
</para><variablelist role="params">
161
<varlistentry><term><parameter>dialog</parameter> :</term>
162
<listitem><simpara> a <link linkend="GtkPageSetupUnixDialog"><type>GtkPageSetupUnixDialog</type></link>
163
</simpara></listitem></varlistentry>
164
<varlistentry><term><parameter>print_settings</parameter> :</term>
165
<listitem><simpara> a <link linkend="GtkPrintSettings"><type>GtkPrintSettings</type></link>
166
</simpara></listitem></varlistentry>
167
</variablelist><para role="since">Since 2.10
170
<title><anchor id="gtk-page-setup-unix-dialog-get-print-settings" role="function" condition="since:2.10"/>gtk_page_setup_unix_dialog_get_print_settings ()</title>
171
<indexterm role="2.10"><primary>gtk_page_setup_unix_dialog_get_print_settings</primary></indexterm><programlisting><link linkend="GtkPrintSettings">GtkPrintSettings</link>* gtk_page_setup_unix_dialog_get_print_settings
172
(<link linkend="GtkPageSetupUnixDialog">GtkPageSetupUnixDialog</link> *dialog);</programlisting>
174
Gets the current print settings from the dialog.</para>
177
</para><variablelist role="params">
178
<varlistentry><term><parameter>dialog</parameter> :</term>
179
<listitem><simpara> a <link linkend="GtkPageSetupUnixDialog"><type>GtkPageSetupUnixDialog</type></link>
180
</simpara></listitem></varlistentry>
181
<varlistentry><term><emphasis>Returns</emphasis> :</term><listitem><simpara> the current print settings
183
</simpara></listitem></varlistentry>
184
</variablelist><para role="since">Since 2.10