1
<refentry id="GtkPrintSettings">
3
<refentrytitle role="top_of_page">GtkPrintSettings</refentrytitle>
4
<manvolnum>3</manvolnum>
5
<refmiscinfo>GTK Library</refmiscinfo>
9
<refname>GtkPrintSettings</refname>
10
<refpurpose>Stores print settings</refpurpose>
11
<!--[<xref linkend="desc" endterm="desc.title"/>]-->
14
<refsynopsisdiv role="synopsis">
15
<title role="synopsis.title">Synopsis</title>
19
#include <gtk/gtk.h>
22
<link linkend="GtkPrintSettings-struct">GtkPrintSettings</link>;
23
<link linkend="void">void</link> (<link linkend="GtkPrintSettingsFunc">*GtkPrintSettingsFunc</link>) (const <link linkend="gchar">gchar</link> *key,
24
const <link linkend="gchar">gchar</link> *value,
25
<link linkend="gpointer">gpointer</link> user_data);
26
<link linkend="GtkPrintSettings">GtkPrintSettings</link>* <link linkend="gtk-print-settings-new">gtk_print_settings_new</link> (void);
27
<link linkend="GtkPrintSettings">GtkPrintSettings</link>* <link linkend="gtk-print-settings-copy">gtk_print_settings_copy</link> (<link linkend="GtkPrintSettings">GtkPrintSettings</link> *other);
28
<link linkend="gboolean">gboolean</link> <link linkend="gtk-print-settings-has-key">gtk_print_settings_has_key</link> (<link linkend="GtkPrintSettings">GtkPrintSettings</link> *settings,
29
const <link linkend="gchar">gchar</link> *key);
30
const <link linkend="gchar">gchar</link>* <link linkend="gtk-print-settings-get">gtk_print_settings_get</link> (<link linkend="GtkPrintSettings">GtkPrintSettings</link> *settings,
31
const <link linkend="gchar">gchar</link> *key);
32
<link linkend="void">void</link> <link linkend="gtk-print-settings-set">gtk_print_settings_set</link> (<link linkend="GtkPrintSettings">GtkPrintSettings</link> *settings,
33
const <link linkend="gchar">gchar</link> *key,
34
const <link linkend="gchar">gchar</link> *value);
35
<link linkend="void">void</link> <link linkend="gtk-print-settings-unset">gtk_print_settings_unset</link> (<link linkend="GtkPrintSettings">GtkPrintSettings</link> *settings,
36
const <link linkend="gchar">gchar</link> *key);
37
<link linkend="void">void</link> <link linkend="gtk-print-settings-foreach">gtk_print_settings_foreach</link> (<link linkend="GtkPrintSettings">GtkPrintSettings</link> *settings,
38
<link linkend="GtkPrintSettingsFunc">GtkPrintSettingsFunc</link> func,
39
<link linkend="gpointer">gpointer</link> user_data);
40
<link linkend="gboolean">gboolean</link> <link linkend="gtk-print-settings-get-bool">gtk_print_settings_get_bool</link> (<link linkend="GtkPrintSettings">GtkPrintSettings</link> *settings,
41
const <link linkend="gchar">gchar</link> *key);
42
<link linkend="void">void</link> <link linkend="gtk-print-settings-set-bool">gtk_print_settings_set_bool</link> (<link linkend="GtkPrintSettings">GtkPrintSettings</link> *settings,
43
const <link linkend="gchar">gchar</link> *key,
44
<link linkend="gboolean">gboolean</link> value);
45
<link linkend="gdouble">gdouble</link> <link linkend="gtk-print-settings-get-double">gtk_print_settings_get_double</link> (<link linkend="GtkPrintSettings">GtkPrintSettings</link> *settings,
46
const <link linkend="gchar">gchar</link> *key);
47
<link linkend="gdouble">gdouble</link> <link linkend="gtk-print-settings-get-double-with-default">gtk_print_settings_get_double_with_default</link>
48
(<link linkend="GtkPrintSettings">GtkPrintSettings</link> *settings,
49
const <link linkend="gchar">gchar</link> *key,
50
<link linkend="gdouble">gdouble</link> def);
51
<link linkend="void">void</link> <link linkend="gtk-print-settings-set-double">gtk_print_settings_set_double</link> (<link linkend="GtkPrintSettings">GtkPrintSettings</link> *settings,
52
const <link linkend="gchar">gchar</link> *key,
53
<link linkend="gdouble">gdouble</link> value);
54
<link linkend="gdouble">gdouble</link> <link linkend="gtk-print-settings-get-length">gtk_print_settings_get_length</link> (<link linkend="GtkPrintSettings">GtkPrintSettings</link> *settings,
55
const <link linkend="gchar">gchar</link> *key,
56
<link linkend="GtkUnit">GtkUnit</link> unit);
57
<link linkend="void">void</link> <link linkend="gtk-print-settings-set-length">gtk_print_settings_set_length</link> (<link linkend="GtkPrintSettings">GtkPrintSettings</link> *settings,
58
const <link linkend="gchar">gchar</link> *key,
59
<link linkend="gdouble">gdouble</link> value,
60
<link linkend="GtkUnit">GtkUnit</link> unit);
61
<link linkend="gint">gint</link> <link linkend="gtk-print-settings-get-int">gtk_print_settings_get_int</link> (<link linkend="GtkPrintSettings">GtkPrintSettings</link> *settings,
62
const <link linkend="gchar">gchar</link> *key);
63
<link linkend="gint">gint</link> <link linkend="gtk-print-settings-get-int-with-default">gtk_print_settings_get_int_with_default</link>
64
(<link linkend="GtkPrintSettings">GtkPrintSettings</link> *settings,
65
const <link linkend="gchar">gchar</link> *key,
66
<link linkend="gint">gint</link> def);
67
<link linkend="void">void</link> <link linkend="gtk-print-settings-set-int">gtk_print_settings_set_int</link> (<link linkend="GtkPrintSettings">GtkPrintSettings</link> *settings,
68
const <link linkend="gchar">gchar</link> *key,
69
<link linkend="gint">gint</link> value);
70
#define <link linkend="GTK-PRINT-SETTINGS-PRINTER:CAPS">GTK_PRINT_SETTINGS_PRINTER</link>
71
const <link linkend="gchar">gchar</link>* <link linkend="gtk-print-settings-get-printer">gtk_print_settings_get_printer</link> (<link linkend="GtkPrintSettings">GtkPrintSettings</link> *settings);
72
<link linkend="void">void</link> <link linkend="gtk-print-settings-set-printer">gtk_print_settings_set_printer</link> (<link linkend="GtkPrintSettings">GtkPrintSettings</link> *settings,
73
const <link linkend="gchar">gchar</link> *printer);
74
enum <link linkend="GtkPageOrientation">GtkPageOrientation</link>;
75
#define <link linkend="GTK-PRINT-SETTINGS-ORIENTATION:CAPS">GTK_PRINT_SETTINGS_ORIENTATION</link>
76
<link linkend="GtkPageOrientation">GtkPageOrientation</link> <link linkend="gtk-print-settings-get-orientation">gtk_print_settings_get_orientation</link> (<link linkend="GtkPrintSettings">GtkPrintSettings</link> *settings);
77
<link linkend="void">void</link> <link linkend="gtk-print-settings-set-orientation">gtk_print_settings_set_orientation</link> (<link linkend="GtkPrintSettings">GtkPrintSettings</link> *settings,
78
<link linkend="GtkPageOrientation">GtkPageOrientation</link> orientation);
79
#define <link linkend="GTK-PRINT-SETTINGS-PAPER-FORMAT:CAPS">GTK_PRINT_SETTINGS_PAPER_FORMAT</link>
80
<link linkend="GtkPaperSize">GtkPaperSize</link>* <link linkend="gtk-print-settings-get-paper-size">gtk_print_settings_get_paper_size</link> (<link linkend="GtkPrintSettings">GtkPrintSettings</link> *settings);
81
<link linkend="void">void</link> <link linkend="gtk-print-settings-set-paper-size">gtk_print_settings_set_paper_size</link> (<link linkend="GtkPrintSettings">GtkPrintSettings</link> *settings,
82
<link linkend="GtkPaperSize">GtkPaperSize</link> *paper_size);
83
#define <link linkend="GTK-PRINT-SETTINGS-PAPER-WIDTH:CAPS">GTK_PRINT_SETTINGS_PAPER_WIDTH</link>
84
<link linkend="gdouble">gdouble</link> <link linkend="gtk-print-settings-get-paper-width">gtk_print_settings_get_paper_width</link> (<link linkend="GtkPrintSettings">GtkPrintSettings</link> *settings,
85
<link linkend="GtkUnit">GtkUnit</link> unit);
86
<link linkend="void">void</link> <link linkend="gtk-print-settings-set-paper-width">gtk_print_settings_set_paper_width</link> (<link linkend="GtkPrintSettings">GtkPrintSettings</link> *settings,
87
<link linkend="gdouble">gdouble</link> width,
88
<link linkend="GtkUnit">GtkUnit</link> unit);
89
#define <link linkend="GTK-PRINT-SETTINGS-PAPER-HEIGHT:CAPS">GTK_PRINT_SETTINGS_PAPER_HEIGHT</link>
90
<link linkend="gdouble">gdouble</link> <link linkend="gtk-print-settings-get-paper-height">gtk_print_settings_get_paper_height</link> (<link linkend="GtkPrintSettings">GtkPrintSettings</link> *settings,
91
<link linkend="GtkUnit">GtkUnit</link> unit);
92
<link linkend="void">void</link> <link linkend="gtk-print-settings-set-paper-height">gtk_print_settings_set_paper_height</link> (<link linkend="GtkPrintSettings">GtkPrintSettings</link> *settings,
93
<link linkend="gdouble">gdouble</link> height,
94
<link linkend="GtkUnit">GtkUnit</link> unit);
95
#define <link linkend="GTK-PRINT-SETTINGS-USE-COLOR:CAPS">GTK_PRINT_SETTINGS_USE_COLOR</link>
96
<link linkend="gboolean">gboolean</link> <link linkend="gtk-print-settings-get-use-color">gtk_print_settings_get_use_color</link> (<link linkend="GtkPrintSettings">GtkPrintSettings</link> *settings);
97
<link linkend="void">void</link> <link linkend="gtk-print-settings-set-use-color">gtk_print_settings_set_use_color</link> (<link linkend="GtkPrintSettings">GtkPrintSettings</link> *settings,
98
<link linkend="gboolean">gboolean</link> use_color);
99
#define <link linkend="GTK-PRINT-SETTINGS-COLLATE:CAPS">GTK_PRINT_SETTINGS_COLLATE</link>
100
<link linkend="gboolean">gboolean</link> <link linkend="gtk-print-settings-get-collate">gtk_print_settings_get_collate</link> (<link linkend="GtkPrintSettings">GtkPrintSettings</link> *settings);
101
<link linkend="void">void</link> <link linkend="gtk-print-settings-set-collate">gtk_print_settings_set_collate</link> (<link linkend="GtkPrintSettings">GtkPrintSettings</link> *settings,
102
<link linkend="gboolean">gboolean</link> collate);
103
#define <link linkend="GTK-PRINT-SETTINGS-REVERSE:CAPS">GTK_PRINT_SETTINGS_REVERSE</link>
104
<link linkend="gboolean">gboolean</link> <link linkend="gtk-print-settings-get-reverse">gtk_print_settings_get_reverse</link> (<link linkend="GtkPrintSettings">GtkPrintSettings</link> *settings);
105
<link linkend="void">void</link> <link linkend="gtk-print-settings-set-reverse">gtk_print_settings_set_reverse</link> (<link linkend="GtkPrintSettings">GtkPrintSettings</link> *settings,
106
<link linkend="gboolean">gboolean</link> reverse);
107
enum <link linkend="GtkPrintDuplex">GtkPrintDuplex</link>;
108
#define <link linkend="GTK-PRINT-SETTINGS-DUPLEX:CAPS">GTK_PRINT_SETTINGS_DUPLEX</link>
109
<link linkend="GtkPrintDuplex">GtkPrintDuplex</link> <link linkend="gtk-print-settings-get-duplex">gtk_print_settings_get_duplex</link> (<link linkend="GtkPrintSettings">GtkPrintSettings</link> *settings);
110
<link linkend="void">void</link> <link linkend="gtk-print-settings-set-duplex">gtk_print_settings_set_duplex</link> (<link linkend="GtkPrintSettings">GtkPrintSettings</link> *settings,
111
<link linkend="GtkPrintDuplex">GtkPrintDuplex</link> duplex);
112
enum <link linkend="GtkPrintQuality">GtkPrintQuality</link>;
113
#define <link linkend="GTK-PRINT-SETTINGS-QUALITY:CAPS">GTK_PRINT_SETTINGS_QUALITY</link>
114
<link linkend="GtkPrintQuality">GtkPrintQuality</link> <link linkend="gtk-print-settings-get-quality">gtk_print_settings_get_quality</link> (<link linkend="GtkPrintSettings">GtkPrintSettings</link> *settings);
115
<link linkend="void">void</link> <link linkend="gtk-print-settings-set-quality">gtk_print_settings_set_quality</link> (<link linkend="GtkPrintSettings">GtkPrintSettings</link> *settings,
116
<link linkend="GtkPrintQuality">GtkPrintQuality</link> quality);
117
#define <link linkend="GTK-PRINT-SETTINGS-N-COPIES:CAPS">GTK_PRINT_SETTINGS_N_COPIES</link>
118
<link linkend="gint">gint</link> <link linkend="gtk-print-settings-get-n-copies">gtk_print_settings_get_n_copies</link> (<link linkend="GtkPrintSettings">GtkPrintSettings</link> *settings);
119
<link linkend="void">void</link> <link linkend="gtk-print-settings-set-n-copies">gtk_print_settings_set_n_copies</link> (<link linkend="GtkPrintSettings">GtkPrintSettings</link> *settings,
120
<link linkend="gint">gint</link> num_copies);
121
#define <link linkend="GTK-PRINT-SETTINGS-NUMBER-UP:CAPS">GTK_PRINT_SETTINGS_NUMBER_UP</link>
122
<link linkend="gint">gint</link> <link linkend="gtk-print-settings-get-number-up">gtk_print_settings_get_number_up</link> (<link linkend="GtkPrintSettings">GtkPrintSettings</link> *settings);
123
<link linkend="void">void</link> <link linkend="gtk-print-settings-set-number-up">gtk_print_settings_set_number_up</link> (<link linkend="GtkPrintSettings">GtkPrintSettings</link> *settings,
124
<link linkend="gint">gint</link> number_up);
125
#define <link linkend="GTK-PRINT-SETTINGS-RESOLUTION:CAPS">GTK_PRINT_SETTINGS_RESOLUTION</link>
126
<link linkend="gint">gint</link> <link linkend="gtk-print-settings-get-resolution">gtk_print_settings_get_resolution</link> (<link linkend="GtkPrintSettings">GtkPrintSettings</link> *settings);
127
<link linkend="void">void</link> <link linkend="gtk-print-settings-set-resolution">gtk_print_settings_set_resolution</link> (<link linkend="GtkPrintSettings">GtkPrintSettings</link> *settings,
128
<link linkend="gint">gint</link> resolution);
129
#define <link linkend="GTK-PRINT-SETTINGS-SCALE:CAPS">GTK_PRINT_SETTINGS_SCALE</link>
130
<link linkend="gdouble">gdouble</link> <link linkend="gtk-print-settings-get-scale">gtk_print_settings_get_scale</link> (<link linkend="GtkPrintSettings">GtkPrintSettings</link> *settings);
131
<link linkend="void">void</link> <link linkend="gtk-print-settings-set-scale">gtk_print_settings_set_scale</link> (<link linkend="GtkPrintSettings">GtkPrintSettings</link> *settings,
132
<link linkend="gdouble">gdouble</link> scale);
133
enum <link linkend="GtkPrintPages">GtkPrintPages</link>;
134
#define <link linkend="GTK-PRINT-SETTINGS-PRINT-PAGES:CAPS">GTK_PRINT_SETTINGS_PRINT_PAGES</link>
135
<link linkend="GtkPrintPages">GtkPrintPages</link> <link linkend="gtk-print-settings-get-print-pages">gtk_print_settings_get_print_pages</link> (<link linkend="GtkPrintSettings">GtkPrintSettings</link> *settings);
136
<link linkend="void">void</link> <link linkend="gtk-print-settings-set-print-pages">gtk_print_settings_set_print_pages</link> (<link linkend="GtkPrintSettings">GtkPrintSettings</link> *settings,
137
<link linkend="GtkPrintPages">GtkPrintPages</link> pages);
138
<link linkend="GtkPageRange">GtkPageRange</link>;
139
#define <link linkend="GTK-PRINT-SETTINGS-PAGE-RANGES:CAPS">GTK_PRINT_SETTINGS_PAGE_RANGES</link>
140
<link linkend="GtkPageRange">GtkPageRange</link>* <link linkend="gtk-print-settings-get-page-ranges">gtk_print_settings_get_page_ranges</link> (<link linkend="GtkPrintSettings">GtkPrintSettings</link> *settings,
141
<link linkend="gint">gint</link> *num_ranges);
142
<link linkend="void">void</link> <link linkend="gtk-print-settings-set-page-ranges">gtk_print_settings_set_page_ranges</link> (<link linkend="GtkPrintSettings">GtkPrintSettings</link> *settings,
143
<link linkend="GtkPageRange">GtkPageRange</link> *page_ranges,
144
<link linkend="gint">gint</link> num_ranges);
145
enum <link linkend="GtkPageSet">GtkPageSet</link>;
146
#define <link linkend="GTK-PRINT-SETTINGS-PAGE-SET:CAPS">GTK_PRINT_SETTINGS_PAGE_SET</link>
147
<link linkend="GtkPageSet">GtkPageSet</link> <link linkend="gtk-print-settings-get-page-set">gtk_print_settings_get_page_set</link> (<link linkend="GtkPrintSettings">GtkPrintSettings</link> *settings);
148
<link linkend="void">void</link> <link linkend="gtk-print-settings-set-page-set">gtk_print_settings_set_page_set</link> (<link linkend="GtkPrintSettings">GtkPrintSettings</link> *settings,
149
<link linkend="GtkPageSet">GtkPageSet</link> page_set);
150
#define <link linkend="GTK-PRINT-SETTINGS-DEFAULT-SOURCE:CAPS">GTK_PRINT_SETTINGS_DEFAULT_SOURCE</link>
151
const <link linkend="gchar">gchar</link>* <link linkend="gtk-print-settings-get-default-source">gtk_print_settings_get_default_source</link>
152
(<link linkend="GtkPrintSettings">GtkPrintSettings</link> *settings);
153
<link linkend="void">void</link> <link linkend="gtk-print-settings-set-default-source">gtk_print_settings_set_default_source</link>
154
(<link linkend="GtkPrintSettings">GtkPrintSettings</link> *settings,
155
const <link linkend="gchar">gchar</link> *default_source);
156
#define <link linkend="GTK-PRINT-SETTINGS-MEDIA-TYPE:CAPS">GTK_PRINT_SETTINGS_MEDIA_TYPE</link>
157
const <link linkend="gchar">gchar</link>* <link linkend="gtk-print-settings-get-media-type">gtk_print_settings_get_media_type</link> (<link linkend="GtkPrintSettings">GtkPrintSettings</link> *settings);
158
<link linkend="void">void</link> <link linkend="gtk-print-settings-set-media-type">gtk_print_settings_set_media_type</link> (<link linkend="GtkPrintSettings">GtkPrintSettings</link> *settings,
159
const <link linkend="gchar">gchar</link> *media_type);
160
#define <link linkend="GTK-PRINT-SETTINGS-DITHER:CAPS">GTK_PRINT_SETTINGS_DITHER</link>
161
const <link linkend="gchar">gchar</link>* <link linkend="gtk-print-settings-get-dither">gtk_print_settings_get_dither</link> (<link linkend="GtkPrintSettings">GtkPrintSettings</link> *settings);
162
<link linkend="void">void</link> <link linkend="gtk-print-settings-set-dither">gtk_print_settings_set_dither</link> (<link linkend="GtkPrintSettings">GtkPrintSettings</link> *settings,
163
const <link linkend="gchar">gchar</link> *dither);
164
#define <link linkend="GTK-PRINT-SETTINGS-FINISHINGS:CAPS">GTK_PRINT_SETTINGS_FINISHINGS</link>
165
const <link linkend="gchar">gchar</link>* <link linkend="gtk-print-settings-get-finishings">gtk_print_settings_get_finishings</link> (<link linkend="GtkPrintSettings">GtkPrintSettings</link> *settings);
166
<link linkend="void">void</link> <link linkend="gtk-print-settings-set-finishings">gtk_print_settings_set_finishings</link> (<link linkend="GtkPrintSettings">GtkPrintSettings</link> *settings,
167
const <link linkend="gchar">gchar</link> *finishings);
168
#define <link linkend="GTK-PRINT-SETTINGS-OUTPUT-BIN:CAPS">GTK_PRINT_SETTINGS_OUTPUT_BIN</link>
169
const <link linkend="gchar">gchar</link>* <link linkend="gtk-print-settings-get-output-bin">gtk_print_settings_get_output_bin</link> (<link linkend="GtkPrintSettings">GtkPrintSettings</link> *settings);
170
<link linkend="void">void</link> <link linkend="gtk-print-settings-set-output-bin">gtk_print_settings_set_output_bin</link> (<link linkend="GtkPrintSettings">GtkPrintSettings</link> *settings,
171
const <link linkend="gchar">gchar</link> *output_bin);
172
#define <link linkend="GTK-PRINT-SETTINGS-OUTPUT-FILE-FORMAT:CAPS">GTK_PRINT_SETTINGS_OUTPUT_FILE_FORMAT</link>
173
#define <link linkend="GTK-PRINT-SETTINGS-OUTPUT-URI:CAPS">GTK_PRINT_SETTINGS_OUTPUT_URI</link>
174
#define <link linkend="GTK-PRINT-SETTINGS-WIN32-DRIVER-EXTRA:CAPS">GTK_PRINT_SETTINGS_WIN32_DRIVER_EXTRA</link>
175
#define <link linkend="GTK-PRINT-SETTINGS-WIN32-DRIVER-VERSION:CAPS">GTK_PRINT_SETTINGS_WIN32_DRIVER_VERSION</link>
181
<refsect1 role="object_hierarchy">
182
<title role="object_hierarchy.title">Object Hierarchy</title>
185
<link linkend="GObject">GObject</link>
186
+----GtkPrintSettings
198
<refsect1 role="desc">
199
<title role="desc.title">Description</title>
201
A GtkPrintSettings object represents the settings of a print dialog in
202
a system-independent way. The main use for this object is that once
203
you've printed you can get a settings object that represents the settings
204
the user chose, and the next time you print you can pass that object in so
205
that the user doesn't have to re-set all his settings.
208
Its also possible to enumerate the settings so that you can easily save
209
the settings for the next time your app runs, or even store them in a
210
document. The predefined keys try to use shared values as much as possible
211
so that moving such a document between systems still works.
214
<!-- TODO example of getting, storing and setting settings -->
217
Printing support was added in GTK+ 2.10.
221
<refsect1 role="details">
222
<title role="details.title">Details</title>
224
<title><anchor id="GtkPrintSettings-struct" role="struct"/>GtkPrintSettings</title>
225
<indexterm><primary>GtkPrintSettings</primary></indexterm><programlisting>typedef struct _GtkPrintSettings GtkPrintSettings;</programlisting>
230
<title><anchor id="GtkPrintSettingsFunc" role="function"/>GtkPrintSettingsFunc ()</title>
231
<indexterm><primary>GtkPrintSettingsFunc</primary></indexterm><programlisting><link linkend="void">void</link> (*GtkPrintSettingsFunc) (const <link linkend="gchar">gchar</link> *key,
232
const <link linkend="gchar">gchar</link> *value,
233
<link linkend="gpointer">gpointer</link> user_data);</programlisting>
236
</para><variablelist role="params">
237
<varlistentry><term><parameter>key</parameter> :</term>
239
</simpara></listitem></varlistentry>
240
<varlistentry><term><parameter>value</parameter> :</term>
242
</simpara></listitem></varlistentry>
243
<varlistentry><term><parameter>user_data</parameter> :</term>
247
</simpara></listitem></varlistentry>
248
</variablelist></refsect2>
250
<title><anchor id="gtk-print-settings-new" role="function" condition="since:2.10"/>gtk_print_settings_new ()</title>
251
<indexterm role="2.10"><primary>gtk_print_settings_new</primary></indexterm><programlisting><link linkend="GtkPrintSettings">GtkPrintSettings</link>* gtk_print_settings_new (void);</programlisting>
253
Creates a new <link linkend="GtkPrintSettings"><type>GtkPrintSettings</type></link> object.</para>
256
</para><variablelist role="params">
257
<varlistentry><term><emphasis>Returns</emphasis> :</term><listitem><simpara> a new <link linkend="GtkPrintSettings"><type>GtkPrintSettings</type></link> object
259
</simpara></listitem></varlistentry>
260
</variablelist><para role="since">Since 2.10
263
<title><anchor id="gtk-print-settings-copy" role="function" condition="since:2.10"/>gtk_print_settings_copy ()</title>
264
<indexterm role="2.10"><primary>gtk_print_settings_copy</primary></indexterm><programlisting><link linkend="GtkPrintSettings">GtkPrintSettings</link>* gtk_print_settings_copy (<link linkend="GtkPrintSettings">GtkPrintSettings</link> *other);</programlisting>
266
Copies a <link linkend="GtkPrintSettings"><type>GtkPrintSettings</type></link> object.</para>
269
</para><variablelist role="params">
270
<varlistentry><term><parameter>other</parameter> :</term>
271
<listitem><simpara> a <link linkend="GtkPrintSettings"><type>GtkPrintSettings</type></link>
272
</simpara></listitem></varlistentry>
273
<varlistentry><term><emphasis>Returns</emphasis> :</term><listitem><simpara> a newly allocated copy of <parameter>other</parameter>
275
</simpara></listitem></varlistentry>
276
</variablelist><para role="since">Since 2.10
279
<title><anchor id="gtk-print-settings-has-key" role="function" condition="since:2.10"/>gtk_print_settings_has_key ()</title>
280
<indexterm role="2.10"><primary>gtk_print_settings_has_key</primary></indexterm><programlisting><link linkend="gboolean">gboolean</link> gtk_print_settings_has_key (<link linkend="GtkPrintSettings">GtkPrintSettings</link> *settings,
281
const <link linkend="gchar">gchar</link> *key);</programlisting>
283
Returns <link linkend="TRUE:CAPS"><literal>TRUE</literal></link>, if a value is associated with <parameter>key</parameter>.</para>
286
</para><variablelist role="params">
287
<varlistentry><term><parameter>settings</parameter> :</term>
288
<listitem><simpara> a <link linkend="GtkPrintSettings"><type>GtkPrintSettings</type></link>
289
</simpara></listitem></varlistentry>
290
<varlistentry><term><parameter>key</parameter> :</term>
291
<listitem><simpara> a key
292
</simpara></listitem></varlistentry>
293
<varlistentry><term><emphasis>Returns</emphasis> :</term><listitem><simpara> <link linkend="TRUE:CAPS"><literal>TRUE</literal></link>, if <parameter>key</parameter> has a value
295
</simpara></listitem></varlistentry>
296
</variablelist><para role="since">Since 2.10
299
<title><anchor id="gtk-print-settings-get" role="function" condition="since:2.10"/>gtk_print_settings_get ()</title>
300
<indexterm role="2.10"><primary>gtk_print_settings_get</primary></indexterm><programlisting>const <link linkend="gchar">gchar</link>* gtk_print_settings_get (<link linkend="GtkPrintSettings">GtkPrintSettings</link> *settings,
301
const <link linkend="gchar">gchar</link> *key);</programlisting>
303
Looks up the string value associated with <parameter>key</parameter>.</para>
306
</para><variablelist role="params">
307
<varlistentry><term><parameter>settings</parameter> :</term>
308
<listitem><simpara> a <link linkend="GtkPrintSettings"><type>GtkPrintSettings</type></link>
309
</simpara></listitem></varlistentry>
310
<varlistentry><term><parameter>key</parameter> :</term>
311
<listitem><simpara> a key
312
</simpara></listitem></varlistentry>
313
<varlistentry><term><emphasis>Returns</emphasis> :</term><listitem><simpara> the string value for <parameter>key</parameter>
315
</simpara></listitem></varlistentry>
316
</variablelist><para role="since">Since 2.10
319
<title><anchor id="gtk-print-settings-set" role="function" condition="since:2.10"/>gtk_print_settings_set ()</title>
320
<indexterm role="2.10"><primary>gtk_print_settings_set</primary></indexterm><programlisting><link linkend="void">void</link> gtk_print_settings_set (<link linkend="GtkPrintSettings">GtkPrintSettings</link> *settings,
321
const <link linkend="gchar">gchar</link> *key,
322
const <link linkend="gchar">gchar</link> *value);</programlisting>
324
Associates <parameter>value</parameter> with <parameter>key</parameter>.</para>
327
</para><variablelist role="params">
328
<varlistentry><term><parameter>settings</parameter> :</term>
329
<listitem><simpara> a <link linkend="GtkPrintSettings"><type>GtkPrintSettings</type></link>
330
</simpara></listitem></varlistentry>
331
<varlistentry><term><parameter>key</parameter> :</term>
332
<listitem><simpara> a key
333
</simpara></listitem></varlistentry>
334
<varlistentry><term><parameter>value</parameter> :</term>
335
<listitem><simpara> a string value, or <link linkend="NULL:CAPS"><literal>NULL</literal></link>
336
</simpara></listitem></varlistentry>
337
</variablelist><para role="since">Since 2.10
340
<title><anchor id="gtk-print-settings-unset" role="function" condition="since:2.10"/>gtk_print_settings_unset ()</title>
341
<indexterm role="2.10"><primary>gtk_print_settings_unset</primary></indexterm><programlisting><link linkend="void">void</link> gtk_print_settings_unset (<link linkend="GtkPrintSettings">GtkPrintSettings</link> *settings,
342
const <link linkend="gchar">gchar</link> *key);</programlisting>
344
Removes any value associated with <parameter>key</parameter>.
345
This has the same effect as setting the value to <link linkend="NULL:CAPS"><literal>NULL</literal></link>.</para>
348
</para><variablelist role="params">
349
<varlistentry><term><parameter>settings</parameter> :</term>
350
<listitem><simpara> a <link linkend="GtkPrintSettings"><type>GtkPrintSettings</type></link>
351
</simpara></listitem></varlistentry>
352
<varlistentry><term><parameter>key</parameter> :</term>
353
<listitem><simpara> a key
354
</simpara></listitem></varlistentry>
355
</variablelist><para role="since">Since 2.10
358
<title><anchor id="gtk-print-settings-foreach" role="function" condition="since:2.10"/>gtk_print_settings_foreach ()</title>
359
<indexterm role="2.10"><primary>gtk_print_settings_foreach</primary></indexterm><programlisting><link linkend="void">void</link> gtk_print_settings_foreach (<link linkend="GtkPrintSettings">GtkPrintSettings</link> *settings,
360
<link linkend="GtkPrintSettingsFunc">GtkPrintSettingsFunc</link> func,
361
<link linkend="gpointer">gpointer</link> user_data);</programlisting>
363
Calls <parameter>func</parameter> for each key-value pair of <parameter>settings</parameter>.</para>
366
</para><variablelist role="params">
367
<varlistentry><term><parameter>settings</parameter> :</term>
368
<listitem><simpara> a <link linkend="GtkPrintSettings"><type>GtkPrintSettings</type></link>
369
</simpara></listitem></varlistentry>
370
<varlistentry><term><parameter>func</parameter> :</term>
371
<listitem><simpara> the function to call
372
</simpara></listitem></varlistentry>
373
<varlistentry><term><parameter>user_data</parameter> :</term>
374
<listitem><simpara> user data for <parameter>func</parameter>
375
</simpara></listitem></varlistentry>
376
</variablelist><para role="since">Since 2.10
379
<title><anchor id="gtk-print-settings-get-bool" role="function" condition="since:2.10"/>gtk_print_settings_get_bool ()</title>
380
<indexterm role="2.10"><primary>gtk_print_settings_get_bool</primary></indexterm><programlisting><link linkend="gboolean">gboolean</link> gtk_print_settings_get_bool (<link linkend="GtkPrintSettings">GtkPrintSettings</link> *settings,
381
const <link linkend="gchar">gchar</link> *key);</programlisting>
383
Returns the boolean represented by the value
384
that is associated with <parameter>key</parameter>.
387
The string "true" represents <link linkend="TRUE:CAPS"><literal>TRUE</literal></link>, any other
388
string <link linkend="FALSE:CAPS"><literal>FALSE</literal></link>.</para>
391
</para><variablelist role="params">
392
<varlistentry><term><parameter>settings</parameter> :</term>
393
<listitem><simpara> a <link linkend="GtkPrintSettings"><type>GtkPrintSettings</type></link>
394
</simpara></listitem></varlistentry>
395
<varlistentry><term><parameter>key</parameter> :</term>
396
<listitem><simpara> a key
397
</simpara></listitem></varlistentry>
398
<varlistentry><term><emphasis>Returns</emphasis> :</term><listitem><simpara> <link linkend="TRUE:CAPS"><literal>TRUE</literal></link>, if <parameter>key</parameter> maps to a true value.
400
</simpara></listitem></varlistentry>
401
</variablelist><para role="since">Since 2.10
404
<title><anchor id="gtk-print-settings-set-bool" role="function" condition="since:2.10"/>gtk_print_settings_set_bool ()</title>
405
<indexterm role="2.10"><primary>gtk_print_settings_set_bool</primary></indexterm><programlisting><link linkend="void">void</link> gtk_print_settings_set_bool (<link linkend="GtkPrintSettings">GtkPrintSettings</link> *settings,
406
const <link linkend="gchar">gchar</link> *key,
407
<link linkend="gboolean">gboolean</link> value);</programlisting>
409
Sets <parameter>key</parameter> to a boolean value.</para>
412
</para><variablelist role="params">
413
<varlistentry><term><parameter>settings</parameter> :</term>
414
<listitem><simpara> a <link linkend="GtkPrintSettings"><type>GtkPrintSettings</type></link>
415
</simpara></listitem></varlistentry>
416
<varlistentry><term><parameter>key</parameter> :</term>
417
<listitem><simpara> a key
418
</simpara></listitem></varlistentry>
419
<varlistentry><term><parameter>value</parameter> :</term>
420
<listitem><simpara> a boolean
421
</simpara></listitem></varlistentry>
422
</variablelist><para role="since">Since 2.10
425
<title><anchor id="gtk-print-settings-get-double" role="function" condition="since:2.10"/>gtk_print_settings_get_double ()</title>
426
<indexterm role="2.10"><primary>gtk_print_settings_get_double</primary></indexterm><programlisting><link linkend="gdouble">gdouble</link> gtk_print_settings_get_double (<link linkend="GtkPrintSettings">GtkPrintSettings</link> *settings,
427
const <link linkend="gchar">gchar</link> *key);</programlisting>
429
Returns the double value associated with <parameter>key</parameter>, or 0.</para>
432
</para><variablelist role="params">
433
<varlistentry><term><parameter>settings</parameter> :</term>
434
<listitem><simpara> a <link linkend="GtkPrintSettings"><type>GtkPrintSettings</type></link>
435
</simpara></listitem></varlistentry>
436
<varlistentry><term><parameter>key</parameter> :</term>
437
<listitem><simpara> a key
438
</simpara></listitem></varlistentry>
439
<varlistentry><term><emphasis>Returns</emphasis> :</term><listitem><simpara> the double value of <parameter>key</parameter>
441
</simpara></listitem></varlistentry>
442
</variablelist><para role="since">Since 2.10
445
<title><anchor id="gtk-print-settings-get-double-with-default" role="function" condition="since:2.10"/>gtk_print_settings_get_double_with_default ()</title>
446
<indexterm role="2.10"><primary>gtk_print_settings_get_double_with_default</primary></indexterm><programlisting><link linkend="gdouble">gdouble</link> gtk_print_settings_get_double_with_default
447
(<link linkend="GtkPrintSettings">GtkPrintSettings</link> *settings,
448
const <link linkend="gchar">gchar</link> *key,
449
<link linkend="gdouble">gdouble</link> def);</programlisting>
451
Returns the floating point number represented by
452
the value that is associated with <parameter>key</parameter>, or <parameter>default_val</parameter>
453
if the value does not represent a floating point number.
456
Floating point numbers are parsed with <link linkend="g-ascii-strtod"><function>g_ascii_strtod()</function></link>.</para>
459
</para><variablelist role="params">
460
<varlistentry><term><parameter>settings</parameter> :</term>
461
<listitem><simpara> a <link linkend="GtkPrintSettings"><type>GtkPrintSettings</type></link>
462
</simpara></listitem></varlistentry>
463
<varlistentry><term><parameter>key</parameter> :</term>
464
<listitem><simpara> a key
465
</simpara></listitem></varlistentry>
466
<varlistentry><term><parameter>def</parameter> :</term>
467
<listitem><simpara> the default value
468
</simpara></listitem></varlistentry>
469
<varlistentry><term><emphasis>Returns</emphasis> :</term><listitem><simpara> the floating point number associated with <parameter>key</parameter>
471
</simpara></listitem></varlistentry>
472
</variablelist><para role="since">Since 2.10
475
<title><anchor id="gtk-print-settings-set-double" role="function" condition="since:2.10"/>gtk_print_settings_set_double ()</title>
476
<indexterm role="2.10"><primary>gtk_print_settings_set_double</primary></indexterm><programlisting><link linkend="void">void</link> gtk_print_settings_set_double (<link linkend="GtkPrintSettings">GtkPrintSettings</link> *settings,
477
const <link linkend="gchar">gchar</link> *key,
478
<link linkend="gdouble">gdouble</link> value);</programlisting>
480
Sets <parameter>key</parameter> to a double value.</para>
483
</para><variablelist role="params">
484
<varlistentry><term><parameter>settings</parameter> :</term>
485
<listitem><simpara> a <link linkend="GtkPrintSettings"><type>GtkPrintSettings</type></link>
486
</simpara></listitem></varlistentry>
487
<varlistentry><term><parameter>key</parameter> :</term>
488
<listitem><simpara> a key
489
</simpara></listitem></varlistentry>
490
<varlistentry><term><parameter>value</parameter> :</term>
491
<listitem><simpara> a double value
492
</simpara></listitem></varlistentry>
493
</variablelist><para role="since">Since 2.10
496
<title><anchor id="gtk-print-settings-get-length" role="function" condition="since:2.10"/>gtk_print_settings_get_length ()</title>
497
<indexterm role="2.10"><primary>gtk_print_settings_get_length</primary></indexterm><programlisting><link linkend="gdouble">gdouble</link> gtk_print_settings_get_length (<link linkend="GtkPrintSettings">GtkPrintSettings</link> *settings,
498
const <link linkend="gchar">gchar</link> *key,
499
<link linkend="GtkUnit">GtkUnit</link> unit);</programlisting>
501
Returns the value associated with <parameter>key</parameter>, interpreted
502
as a length. The returned value is converted to <parameter>units</parameter>.</para>
505
</para><variablelist role="params">
506
<varlistentry><term><parameter>settings</parameter> :</term>
507
<listitem><simpara> a <link linkend="GtkPrintSettings"><type>GtkPrintSettings</type></link>
508
</simpara></listitem></varlistentry>
509
<varlistentry><term><parameter>key</parameter> :</term>
510
<listitem><simpara> a key
511
</simpara></listitem></varlistentry>
512
<varlistentry><term><parameter>unit</parameter> :</term>
513
<listitem><simpara> the unit of the return value
514
</simpara></listitem></varlistentry>
515
<varlistentry><term><emphasis>Returns</emphasis> :</term><listitem><simpara> the length value of <parameter>key</parameter>, converted to <parameter>unit</parameter>
517
</simpara></listitem></varlistentry>
518
</variablelist><para role="since">Since 2.10
521
<title><anchor id="gtk-print-settings-set-length" role="function" condition="since:2.10"/>gtk_print_settings_set_length ()</title>
522
<indexterm role="2.10"><primary>gtk_print_settings_set_length</primary></indexterm><programlisting><link linkend="void">void</link> gtk_print_settings_set_length (<link linkend="GtkPrintSettings">GtkPrintSettings</link> *settings,
523
const <link linkend="gchar">gchar</link> *key,
524
<link linkend="gdouble">gdouble</link> value,
525
<link linkend="GtkUnit">GtkUnit</link> unit);</programlisting>
527
Associates a length in units of <parameter>unit</parameter> with <parameter>key</parameter>.</para>
530
</para><variablelist role="params">
531
<varlistentry><term><parameter>settings</parameter> :</term>
532
<listitem><simpara> a <link linkend="GtkPrintSettings"><type>GtkPrintSettings</type></link>
533
</simpara></listitem></varlistentry>
534
<varlistentry><term><parameter>key</parameter> :</term>
535
<listitem><simpara> a key
536
</simpara></listitem></varlistentry>
537
<varlistentry><term><parameter>value</parameter> :</term>
538
<listitem><simpara> a length
539
</simpara></listitem></varlistentry>
540
<varlistentry><term><parameter>unit</parameter> :</term>
541
<listitem><simpara> the unit of <parameter>length</parameter>
542
</simpara></listitem></varlistentry>
543
</variablelist><para role="since">Since 2.10
546
<title><anchor id="gtk-print-settings-get-int" role="function" condition="since:2.10"/>gtk_print_settings_get_int ()</title>
547
<indexterm role="2.10"><primary>gtk_print_settings_get_int</primary></indexterm><programlisting><link linkend="gint">gint</link> gtk_print_settings_get_int (<link linkend="GtkPrintSettings">GtkPrintSettings</link> *settings,
548
const <link linkend="gchar">gchar</link> *key);</programlisting>
550
Returns the integer value of <parameter>key</parameter>, or 0.</para>
553
</para><variablelist role="params">
554
<varlistentry><term><parameter>settings</parameter> :</term>
555
<listitem><simpara> a <link linkend="GtkPrintSettings"><type>GtkPrintSettings</type></link>
556
</simpara></listitem></varlistentry>
557
<varlistentry><term><parameter>key</parameter> :</term>
558
<listitem><simpara> a key
559
</simpara></listitem></varlistentry>
560
<varlistentry><term><emphasis>Returns</emphasis> :</term><listitem><simpara> the integer value of <parameter>key</parameter>
562
</simpara></listitem></varlistentry>
563
</variablelist><para role="since">Since 2.10
566
<title><anchor id="gtk-print-settings-get-int-with-default" role="function" condition="since:2.10"/>gtk_print_settings_get_int_with_default ()</title>
567
<indexterm role="2.10"><primary>gtk_print_settings_get_int_with_default</primary></indexterm><programlisting><link linkend="gint">gint</link> gtk_print_settings_get_int_with_default
568
(<link linkend="GtkPrintSettings">GtkPrintSettings</link> *settings,
569
const <link linkend="gchar">gchar</link> *key,
570
<link linkend="gint">gint</link> def);</programlisting>
572
Returns the value of <parameter>key</parameter>, interpreted as
573
an integer, or the default value.</para>
576
</para><variablelist role="params">
577
<varlistentry><term><parameter>settings</parameter> :</term>
578
<listitem><simpara> a <link linkend="GtkPrintSettings"><type>GtkPrintSettings</type></link>
579
</simpara></listitem></varlistentry>
580
<varlistentry><term><parameter>key</parameter> :</term>
581
<listitem><simpara> a key
582
</simpara></listitem></varlistentry>
583
<varlistentry><term><parameter>def</parameter> :</term>
584
<listitem><simpara> the default value
585
</simpara></listitem></varlistentry>
586
<varlistentry><term><emphasis>Returns</emphasis> :</term><listitem><simpara> the integer value of <parameter>key</parameter>
588
</simpara></listitem></varlistentry>
589
</variablelist><para role="since">Since 2.10
592
<title><anchor id="gtk-print-settings-set-int" role="function" condition="since:2.10"/>gtk_print_settings_set_int ()</title>
593
<indexterm role="2.10"><primary>gtk_print_settings_set_int</primary></indexterm><programlisting><link linkend="void">void</link> gtk_print_settings_set_int (<link linkend="GtkPrintSettings">GtkPrintSettings</link> *settings,
594
const <link linkend="gchar">gchar</link> *key,
595
<link linkend="gint">gint</link> value);</programlisting>
597
Sets <parameter>key</parameter> to an integer value.</para>
600
</para><variablelist role="params">
601
<varlistentry><term><parameter>settings</parameter> :</term>
602
<listitem><simpara> a <link linkend="GtkPrintSettings"><type>GtkPrintSettings</type></link>
603
</simpara></listitem></varlistentry>
604
<varlistentry><term><parameter>key</parameter> :</term>
605
<listitem><simpara> a key
606
</simpara></listitem></varlistentry>
607
<varlistentry><term><parameter>value</parameter> :</term>
608
<listitem><simpara> an integer
609
</simpara></listitem></varlistentry>
610
</variablelist><para role="since">Since 2.10
613
<title><anchor id="GTK-PRINT-SETTINGS-PRINTER:CAPS" role="macro"/>GTK_PRINT_SETTINGS_PRINTER</title>
614
<indexterm><primary>GTK_PRINT_SETTINGS_PRINTER</primary></indexterm><programlisting>#define GTK_PRINT_SETTINGS_PRINTER "printer"
620
<title><anchor id="gtk-print-settings-get-printer" role="function" condition="since:2.10"/>gtk_print_settings_get_printer ()</title>
621
<indexterm role="2.10"><primary>gtk_print_settings_get_printer</primary></indexterm><programlisting>const <link linkend="gchar">gchar</link>* gtk_print_settings_get_printer (<link linkend="GtkPrintSettings">GtkPrintSettings</link> *settings);</programlisting>
623
Convenience function to obtain the value of
624
<link linkend="GTK-PRINT-SETTINGS-PRINTER:CAPS"><literal>GTK_PRINT_SETTINGS_PRINTER</literal></link>.</para>
627
</para><variablelist role="params">
628
<varlistentry><term><parameter>settings</parameter> :</term>
629
<listitem><simpara> a <link linkend="GtkPrintSettings"><type>GtkPrintSettings</type></link>
630
</simpara></listitem></varlistentry>
631
<varlistentry><term><emphasis>Returns</emphasis> :</term><listitem><simpara> the printer name
633
</simpara></listitem></varlistentry>
634
</variablelist><para role="since">Since 2.10
637
<title><anchor id="gtk-print-settings-set-printer" role="function" condition="since:2.10"/>gtk_print_settings_set_printer ()</title>
638
<indexterm role="2.10"><primary>gtk_print_settings_set_printer</primary></indexterm><programlisting><link linkend="void">void</link> gtk_print_settings_set_printer (<link linkend="GtkPrintSettings">GtkPrintSettings</link> *settings,
639
const <link linkend="gchar">gchar</link> *printer);</programlisting>
641
Convenience function to set <link linkend="GTK-PRINT-SETTINGS-PRINTER:CAPS"><literal>GTK_PRINT_SETTINGS_PRINTER</literal></link>
642
to <parameter>printer</parameter>.</para>
645
</para><variablelist role="params">
646
<varlistentry><term><parameter>settings</parameter> :</term>
647
<listitem><simpara> a <link linkend="GtkPrintSettings"><type>GtkPrintSettings</type></link>
648
</simpara></listitem></varlistentry>
649
<varlistentry><term><parameter>printer</parameter> :</term>
650
<listitem><simpara> the printer name
651
</simpara></listitem></varlistentry>
652
</variablelist><para role="since">Since 2.10
655
<title><anchor id="GtkPageOrientation" role="enum"/>enum GtkPageOrientation</title>
656
<indexterm><primary>GtkPageOrientation</primary></indexterm><programlisting>typedef enum {
657
GTK_PAGE_ORIENTATION_PORTRAIT,
658
GTK_PAGE_ORIENTATION_LANDSCAPE,
659
GTK_PAGE_ORIENTATION_REVERSE_PORTRAIT,
660
GTK_PAGE_ORIENTATION_REVERSE_LANDSCAPE
661
} GtkPageOrientation;
667
<title><anchor id="GTK-PRINT-SETTINGS-ORIENTATION:CAPS" role="macro"/>GTK_PRINT_SETTINGS_ORIENTATION</title>
668
<indexterm><primary>GTK_PRINT_SETTINGS_ORIENTATION</primary></indexterm><programlisting>#define GTK_PRINT_SETTINGS_ORIENTATION "orientation"
674
<title><anchor id="gtk-print-settings-get-orientation" role="function" condition="since:2.10"/>gtk_print_settings_get_orientation ()</title>
675
<indexterm role="2.10"><primary>gtk_print_settings_get_orientation</primary></indexterm><programlisting><link linkend="GtkPageOrientation">GtkPageOrientation</link> gtk_print_settings_get_orientation (<link linkend="GtkPrintSettings">GtkPrintSettings</link> *settings);</programlisting>
677
Get the value of <link linkend="GTK-PRINT-SETTINGS-ORIENTATION:CAPS"><literal>GTK_PRINT_SETTINGS_ORIENTATION</literal></link>,
678
converted to a <link linkend="GtkPageOrientation"><type>GtkPageOrientation</type></link>.</para>
681
</para><variablelist role="params">
682
<varlistentry><term><parameter>settings</parameter> :</term>
683
<listitem><simpara> a <link linkend="GtkPrintSettings"><type>GtkPrintSettings</type></link>
684
</simpara></listitem></varlistentry>
685
<varlistentry><term><emphasis>Returns</emphasis> :</term><listitem><simpara> the orientation
687
</simpara></listitem></varlistentry>
688
</variablelist><para role="since">Since 2.10
691
<title><anchor id="gtk-print-settings-set-orientation" role="function" condition="since:2.10"/>gtk_print_settings_set_orientation ()</title>
692
<indexterm role="2.10"><primary>gtk_print_settings_set_orientation</primary></indexterm><programlisting><link linkend="void">void</link> gtk_print_settings_set_orientation (<link linkend="GtkPrintSettings">GtkPrintSettings</link> *settings,
693
<link linkend="GtkPageOrientation">GtkPageOrientation</link> orientation);</programlisting>
695
Sets the value of <link linkend="GTK-PRINT-SETTINGS-ORIENTATION:CAPS"><literal>GTK_PRINT_SETTINGS_ORIENTATION</literal></link>.</para>
698
</para><variablelist role="params">
699
<varlistentry><term><parameter>settings</parameter> :</term>
700
<listitem><simpara> a <link linkend="GtkPrintSettings"><type>GtkPrintSettings</type></link>
701
</simpara></listitem></varlistentry>
702
<varlistentry><term><parameter>orientation</parameter> :</term>
703
<listitem><simpara> a page orientation
704
</simpara></listitem></varlistentry>
705
</variablelist><para role="since">Since 2.10
708
<title><anchor id="GTK-PRINT-SETTINGS-PAPER-FORMAT:CAPS" role="macro"/>GTK_PRINT_SETTINGS_PAPER_FORMAT</title>
709
<indexterm><primary>GTK_PRINT_SETTINGS_PAPER_FORMAT</primary></indexterm><programlisting>#define GTK_PRINT_SETTINGS_PAPER_FORMAT "paper-format"
715
<title><anchor id="gtk-print-settings-get-paper-size" role="function" condition="since:2.10"/>gtk_print_settings_get_paper_size ()</title>
716
<indexterm role="2.10"><primary>gtk_print_settings_get_paper_size</primary></indexterm><programlisting><link linkend="GtkPaperSize">GtkPaperSize</link>* gtk_print_settings_get_paper_size (<link linkend="GtkPrintSettings">GtkPrintSettings</link> *settings);</programlisting>
718
Gets the value of <link linkend="GTK-PRINT-SETTINGS-PAPER-FORMAT:CAPS"><literal>GTK_PRINT_SETTINGS_PAPER_FORMAT</literal></link>,
719
converted to a <link linkend="GtkPaperSize"><type>GtkPaperSize</type></link>.</para>
722
</para><variablelist role="params">
723
<varlistentry><term><parameter>settings</parameter> :</term>
724
<listitem><simpara> a <link linkend="GtkPrintSettings"><type>GtkPrintSettings</type></link>
725
</simpara></listitem></varlistentry>
726
<varlistentry><term><emphasis>Returns</emphasis> :</term><listitem><simpara> the paper size
728
</simpara></listitem></varlistentry>
729
</variablelist><para role="since">Since 2.10
732
<title><anchor id="gtk-print-settings-set-paper-size" role="function" condition="since:2.10"/>gtk_print_settings_set_paper_size ()</title>
733
<indexterm role="2.10"><primary>gtk_print_settings_set_paper_size</primary></indexterm><programlisting><link linkend="void">void</link> gtk_print_settings_set_paper_size (<link linkend="GtkPrintSettings">GtkPrintSettings</link> *settings,
734
<link linkend="GtkPaperSize">GtkPaperSize</link> *paper_size);</programlisting>
736
Sets the value of <link linkend="GTK-PRINT-SETTINGS-PAPER-FORMAT:CAPS"><literal>GTK_PRINT_SETTINGS_PAPER_FORMAT</literal></link>,
737
<link linkend="GTK-PRINT-SETTINGS-PAPER-WIDTH:CAPS"><literal>GTK_PRINT_SETTINGS_PAPER_WIDTH</literal></link> and
738
<link linkend="GTK-PRINT-SETTINGS-PAPER-HEIGHT:CAPS"><literal>GTK_PRINT_SETTINGS_PAPER_HEIGHT</literal></link>.</para>
741
</para><variablelist role="params">
742
<varlistentry><term><parameter>settings</parameter> :</term>
743
<listitem><simpara> a <link linkend="GtkPrintSettings"><type>GtkPrintSettings</type></link>
744
</simpara></listitem></varlistentry>
745
<varlistentry><term><parameter>paper_size</parameter> :</term>
746
<listitem><simpara> a paper size
747
</simpara></listitem></varlistentry>
748
</variablelist><para role="since">Since 2.10
751
<title><anchor id="GTK-PRINT-SETTINGS-PAPER-WIDTH:CAPS" role="macro"/>GTK_PRINT_SETTINGS_PAPER_WIDTH</title>
752
<indexterm><primary>GTK_PRINT_SETTINGS_PAPER_WIDTH</primary></indexterm><programlisting>#define GTK_PRINT_SETTINGS_PAPER_WIDTH "paper-width"
758
<title><anchor id="gtk-print-settings-get-paper-width" role="function" condition="since:2.10"/>gtk_print_settings_get_paper_width ()</title>
759
<indexterm role="2.10"><primary>gtk_print_settings_get_paper_width</primary></indexterm><programlisting><link linkend="gdouble">gdouble</link> gtk_print_settings_get_paper_width (<link linkend="GtkPrintSettings">GtkPrintSettings</link> *settings,
760
<link linkend="GtkUnit">GtkUnit</link> unit);</programlisting>
762
Gets the value of <link linkend="GTK-PRINT-SETTINGS-PAPER-WIDTH:CAPS"><literal>GTK_PRINT_SETTINGS_PAPER_WIDTH</literal></link>,
763
converted to <parameter>unit</parameter>.</para>
766
</para><variablelist role="params">
767
<varlistentry><term><parameter>settings</parameter> :</term>
768
<listitem><simpara> a <link linkend="GtkPrintSettings"><type>GtkPrintSettings</type></link>
769
</simpara></listitem></varlistentry>
770
<varlistentry><term><parameter>unit</parameter> :</term>
771
<listitem><simpara> the unit for the return value
772
</simpara></listitem></varlistentry>
773
<varlistentry><term><emphasis>Returns</emphasis> :</term><listitem><simpara> the paper width, in units of <parameter>unit</parameter>
775
</simpara></listitem></varlistentry>
776
</variablelist><para role="since">Since 2.10
779
<title><anchor id="gtk-print-settings-set-paper-width" role="function" condition="since:2.10"/>gtk_print_settings_set_paper_width ()</title>
780
<indexterm role="2.10"><primary>gtk_print_settings_set_paper_width</primary></indexterm><programlisting><link linkend="void">void</link> gtk_print_settings_set_paper_width (<link linkend="GtkPrintSettings">GtkPrintSettings</link> *settings,
781
<link linkend="gdouble">gdouble</link> width,
782
<link linkend="GtkUnit">GtkUnit</link> unit);</programlisting>
784
Sets the value of <link linkend="GTK-PRINT-SETTINGS-PAPER-WIDTH:CAPS"><literal>GTK_PRINT_SETTINGS_PAPER_WIDTH</literal></link>.</para>
787
</para><variablelist role="params">
788
<varlistentry><term><parameter>settings</parameter> :</term>
789
<listitem><simpara> a <link linkend="GtkPrintSettings"><type>GtkPrintSettings</type></link>
790
</simpara></listitem></varlistentry>
791
<varlistentry><term><parameter>width</parameter> :</term>
792
<listitem><simpara> the paper width
793
</simpara></listitem></varlistentry>
794
<varlistentry><term><parameter>unit</parameter> :</term>
795
<listitem><simpara> the units of <parameter>width</parameter>
796
</simpara></listitem></varlistentry>
797
</variablelist><para role="since">Since 2.10
800
<title><anchor id="GTK-PRINT-SETTINGS-PAPER-HEIGHT:CAPS" role="macro"/>GTK_PRINT_SETTINGS_PAPER_HEIGHT</title>
801
<indexterm><primary>GTK_PRINT_SETTINGS_PAPER_HEIGHT</primary></indexterm><programlisting>#define GTK_PRINT_SETTINGS_PAPER_HEIGHT "paper-height"
807
<title><anchor id="gtk-print-settings-get-paper-height" role="function" condition="since:2.10"/>gtk_print_settings_get_paper_height ()</title>
808
<indexterm role="2.10"><primary>gtk_print_settings_get_paper_height</primary></indexterm><programlisting><link linkend="gdouble">gdouble</link> gtk_print_settings_get_paper_height (<link linkend="GtkPrintSettings">GtkPrintSettings</link> *settings,
809
<link linkend="GtkUnit">GtkUnit</link> unit);</programlisting>
811
Gets the value of <link linkend="GTK-PRINT-SETTINGS-PAPER-HEIGHT:CAPS"><literal>GTK_PRINT_SETTINGS_PAPER_HEIGHT</literal></link>,
812
converted to <parameter>unit</parameter>.</para>
815
</para><variablelist role="params">
816
<varlistentry><term><parameter>settings</parameter> :</term>
817
<listitem><simpara> a <link linkend="GtkPrintSettings"><type>GtkPrintSettings</type></link>
818
</simpara></listitem></varlistentry>
819
<varlistentry><term><parameter>unit</parameter> :</term>
820
<listitem><simpara> the unit for the return value
821
</simpara></listitem></varlistentry>
822
<varlistentry><term><emphasis>Returns</emphasis> :</term><listitem><simpara> the paper height, in units of <parameter>unit</parameter>
824
</simpara></listitem></varlistentry>
825
</variablelist><para role="since">Since 2.10
828
<title><anchor id="gtk-print-settings-set-paper-height" role="function" condition="since:2.10"/>gtk_print_settings_set_paper_height ()</title>
829
<indexterm role="2.10"><primary>gtk_print_settings_set_paper_height</primary></indexterm><programlisting><link linkend="void">void</link> gtk_print_settings_set_paper_height (<link linkend="GtkPrintSettings">GtkPrintSettings</link> *settings,
830
<link linkend="gdouble">gdouble</link> height,
831
<link linkend="GtkUnit">GtkUnit</link> unit);</programlisting>
833
Sets the value of <link linkend="GTK-PRINT-SETTINGS-PAPER-HEIGHT:CAPS"><literal>GTK_PRINT_SETTINGS_PAPER_HEIGHT</literal></link>.</para>
836
</para><variablelist role="params">
837
<varlistentry><term><parameter>settings</parameter> :</term>
838
<listitem><simpara> a <link linkend="GtkPrintSettings"><type>GtkPrintSettings</type></link>
839
</simpara></listitem></varlistentry>
840
<varlistentry><term><parameter>height</parameter> :</term>
841
<listitem><simpara> the paper height
842
</simpara></listitem></varlistentry>
843
<varlistentry><term><parameter>unit</parameter> :</term>
844
<listitem><simpara> the units of <parameter>height</parameter>
845
</simpara></listitem></varlistentry>
846
</variablelist><para role="since">Since 2.10
849
<title><anchor id="GTK-PRINT-SETTINGS-USE-COLOR:CAPS" role="macro"/>GTK_PRINT_SETTINGS_USE_COLOR</title>
850
<indexterm><primary>GTK_PRINT_SETTINGS_USE_COLOR</primary></indexterm><programlisting>#define GTK_PRINT_SETTINGS_USE_COLOR "use-color"
856
<title><anchor id="gtk-print-settings-get-use-color" role="function" condition="since:2.10"/>gtk_print_settings_get_use_color ()</title>
857
<indexterm role="2.10"><primary>gtk_print_settings_get_use_color</primary></indexterm><programlisting><link linkend="gboolean">gboolean</link> gtk_print_settings_get_use_color (<link linkend="GtkPrintSettings">GtkPrintSettings</link> *settings);</programlisting>
859
Gets the value of <link linkend="GTK-PRINT-SETTINGS-USE-COLOR:CAPS"><literal>GTK_PRINT_SETTINGS_USE_COLOR</literal></link>.</para>
862
</para><variablelist role="params">
863
<varlistentry><term><parameter>settings</parameter> :</term>
864
<listitem><simpara> a <link linkend="GtkPrintSettings"><type>GtkPrintSettings</type></link>
865
</simpara></listitem></varlistentry>
866
<varlistentry><term><emphasis>Returns</emphasis> :</term><listitem><simpara> whether to use color
868
</simpara></listitem></varlistentry>
869
</variablelist><para role="since">Since 2.10
872
<title><anchor id="gtk-print-settings-set-use-color" role="function" condition="since:2.10"/>gtk_print_settings_set_use_color ()</title>
873
<indexterm role="2.10"><primary>gtk_print_settings_set_use_color</primary></indexterm><programlisting><link linkend="void">void</link> gtk_print_settings_set_use_color (<link linkend="GtkPrintSettings">GtkPrintSettings</link> *settings,
874
<link linkend="gboolean">gboolean</link> use_color);</programlisting>
876
Sets the value of <link linkend="GTK-PRINT-SETTINGS-USE-COLOR:CAPS"><literal>GTK_PRINT_SETTINGS_USE_COLOR</literal></link>.</para>
879
</para><variablelist role="params">
880
<varlistentry><term><parameter>settings</parameter> :</term>
881
<listitem><simpara> a <link linkend="GtkPrintSettings"><type>GtkPrintSettings</type></link>
882
</simpara></listitem></varlistentry>
883
<varlistentry><term><parameter>use_color</parameter> :</term>
884
<listitem><simpara> whether to use color
885
</simpara></listitem></varlistentry>
886
</variablelist><para role="since">Since 2.10
889
<title><anchor id="GTK-PRINT-SETTINGS-COLLATE:CAPS" role="macro"/>GTK_PRINT_SETTINGS_COLLATE</title>
890
<indexterm><primary>GTK_PRINT_SETTINGS_COLLATE</primary></indexterm><programlisting>#define GTK_PRINT_SETTINGS_COLLATE "collate"
896
<title><anchor id="gtk-print-settings-get-collate" role="function" condition="since:2.10"/>gtk_print_settings_get_collate ()</title>
897
<indexterm role="2.10"><primary>gtk_print_settings_get_collate</primary></indexterm><programlisting><link linkend="gboolean">gboolean</link> gtk_print_settings_get_collate (<link linkend="GtkPrintSettings">GtkPrintSettings</link> *settings);</programlisting>
899
Gets the value of <link linkend="GTK-PRINT-SETTINGS-COLLATE:CAPS"><literal>GTK_PRINT_SETTINGS_COLLATE</literal></link>.</para>
902
</para><variablelist role="params">
903
<varlistentry><term><parameter>settings</parameter> :</term>
904
<listitem><simpara> a <link linkend="GtkPrintSettings"><type>GtkPrintSettings</type></link>
905
</simpara></listitem></varlistentry>
906
<varlistentry><term><emphasis>Returns</emphasis> :</term><listitem><simpara> whether to collate the printed pages
908
</simpara></listitem></varlistentry>
909
</variablelist><para role="since">Since 2.10
912
<title><anchor id="gtk-print-settings-set-collate" role="function" condition="since:2.10"/>gtk_print_settings_set_collate ()</title>
913
<indexterm role="2.10"><primary>gtk_print_settings_set_collate</primary></indexterm><programlisting><link linkend="void">void</link> gtk_print_settings_set_collate (<link linkend="GtkPrintSettings">GtkPrintSettings</link> *settings,
914
<link linkend="gboolean">gboolean</link> collate);</programlisting>
916
Sets the value of <link linkend="GTK-PRINT-SETTINGS-COLLATE:CAPS"><literal>GTK_PRINT_SETTINGS_COLLATE</literal></link>.</para>
919
</para><variablelist role="params">
920
<varlistentry><term><parameter>settings</parameter> :</term>
921
<listitem><simpara> a <link linkend="GtkPrintSettings"><type>GtkPrintSettings</type></link>
922
</simpara></listitem></varlistentry>
923
<varlistentry><term><parameter>collate</parameter> :</term>
924
<listitem><simpara> whether to collate the output
925
</simpara></listitem></varlistentry>
926
</variablelist><para role="since">Since 2.10
929
<title><anchor id="GTK-PRINT-SETTINGS-REVERSE:CAPS" role="macro"/>GTK_PRINT_SETTINGS_REVERSE</title>
930
<indexterm><primary>GTK_PRINT_SETTINGS_REVERSE</primary></indexterm><programlisting>#define GTK_PRINT_SETTINGS_REVERSE "reverse"
936
<title><anchor id="gtk-print-settings-get-reverse" role="function" condition="since:2.10"/>gtk_print_settings_get_reverse ()</title>
937
<indexterm role="2.10"><primary>gtk_print_settings_get_reverse</primary></indexterm><programlisting><link linkend="gboolean">gboolean</link> gtk_print_settings_get_reverse (<link linkend="GtkPrintSettings">GtkPrintSettings</link> *settings);</programlisting>
939
Gets the value of <link linkend="GTK-PRINT-SETTINGS-REVERSE:CAPS"><literal>GTK_PRINT_SETTINGS_REVERSE</literal></link>.</para>
942
</para><variablelist role="params">
943
<varlistentry><term><parameter>settings</parameter> :</term>
944
<listitem><simpara> a <link linkend="GtkPrintSettings"><type>GtkPrintSettings</type></link>
945
</simpara></listitem></varlistentry>
946
<varlistentry><term><emphasis>Returns</emphasis> :</term><listitem><simpara> whether to reverse the order of the printed pages
948
</simpara></listitem></varlistentry>
949
</variablelist><para role="since">Since 2.10
952
<title><anchor id="gtk-print-settings-set-reverse" role="function" condition="since:2.10"/>gtk_print_settings_set_reverse ()</title>
953
<indexterm role="2.10"><primary>gtk_print_settings_set_reverse</primary></indexterm><programlisting><link linkend="void">void</link> gtk_print_settings_set_reverse (<link linkend="GtkPrintSettings">GtkPrintSettings</link> *settings,
954
<link linkend="gboolean">gboolean</link> reverse);</programlisting>
956
Sets the value of <link linkend="GTK-PRINT-SETTINGS-REVERSE:CAPS"><literal>GTK_PRINT_SETTINGS_REVERSE</literal></link>.</para>
959
</para><variablelist role="params">
960
<varlistentry><term><parameter>settings</parameter> :</term>
961
<listitem><simpara> a <link linkend="GtkPrintSettings"><type>GtkPrintSettings</type></link>
962
</simpara></listitem></varlistentry>
963
<varlistentry><term><parameter>reverse</parameter> :</term>
964
<listitem><simpara> whether to reverse the output
965
</simpara></listitem></varlistentry>
966
</variablelist><para role="since">Since 2.10
969
<title><anchor id="GtkPrintDuplex" role="enum"/>enum GtkPrintDuplex</title>
970
<indexterm><primary>GtkPrintDuplex</primary></indexterm><programlisting>typedef enum {
971
GTK_PRINT_DUPLEX_SIMPLEX,
972
GTK_PRINT_DUPLEX_HORIZONTAL,
973
GTK_PRINT_DUPLEX_VERTICAL
980
<title><anchor id="GTK-PRINT-SETTINGS-DUPLEX:CAPS" role="macro"/>GTK_PRINT_SETTINGS_DUPLEX</title>
981
<indexterm><primary>GTK_PRINT_SETTINGS_DUPLEX</primary></indexterm><programlisting>#define GTK_PRINT_SETTINGS_DUPLEX "duplex"
987
<title><anchor id="gtk-print-settings-get-duplex" role="function" condition="since:2.10"/>gtk_print_settings_get_duplex ()</title>
988
<indexterm role="2.10"><primary>gtk_print_settings_get_duplex</primary></indexterm><programlisting><link linkend="GtkPrintDuplex">GtkPrintDuplex</link> gtk_print_settings_get_duplex (<link linkend="GtkPrintSettings">GtkPrintSettings</link> *settings);</programlisting>
990
Gets the value of <link linkend="GTK-PRINT-SETTINGS-DUPLEX:CAPS"><literal>GTK_PRINT_SETTINGS_DUPLEX</literal></link>.</para>
993
</para><variablelist role="params">
994
<varlistentry><term><parameter>settings</parameter> :</term>
995
<listitem><simpara> a <link linkend="GtkPrintSettings"><type>GtkPrintSettings</type></link>
996
</simpara></listitem></varlistentry>
997
<varlistentry><term><emphasis>Returns</emphasis> :</term><listitem><simpara> whether to print the output in duplex.
999
</simpara></listitem></varlistentry>
1000
</variablelist><para role="since">Since 2.10
1003
<title><anchor id="gtk-print-settings-set-duplex" role="function" condition="since:2.10"/>gtk_print_settings_set_duplex ()</title>
1004
<indexterm role="2.10"><primary>gtk_print_settings_set_duplex</primary></indexterm><programlisting><link linkend="void">void</link> gtk_print_settings_set_duplex (<link linkend="GtkPrintSettings">GtkPrintSettings</link> *settings,
1005
<link linkend="GtkPrintDuplex">GtkPrintDuplex</link> duplex);</programlisting>
1007
Sets the value of <link linkend="GTK-PRINT-SETTINGS-DUPLEX:CAPS"><literal>GTK_PRINT_SETTINGS_DUPLEX</literal></link>.</para>
1010
</para><variablelist role="params">
1011
<varlistentry><term><parameter>settings</parameter> :</term>
1012
<listitem><simpara> a <link linkend="GtkPrintSettings"><type>GtkPrintSettings</type></link>
1013
</simpara></listitem></varlistentry>
1014
<varlistentry><term><parameter>duplex</parameter> :</term>
1015
<listitem><simpara> a <link linkend="GtkPrintDuplex"><type>GtkPrintDuplex</type></link> value
1016
</simpara></listitem></varlistentry>
1017
</variablelist><para role="since">Since 2.10
1020
<title><anchor id="GtkPrintQuality" role="enum"/>enum GtkPrintQuality</title>
1021
<indexterm><primary>GtkPrintQuality</primary></indexterm><programlisting>typedef enum {
1022
GTK_PRINT_QUALITY_LOW,
1023
GTK_PRINT_QUALITY_NORMAL,
1024
GTK_PRINT_QUALITY_HIGH,
1025
GTK_PRINT_QUALITY_DRAFT
1032
<title><anchor id="GTK-PRINT-SETTINGS-QUALITY:CAPS" role="macro"/>GTK_PRINT_SETTINGS_QUALITY</title>
1033
<indexterm><primary>GTK_PRINT_SETTINGS_QUALITY</primary></indexterm><programlisting>#define GTK_PRINT_SETTINGS_QUALITY "quality"
1039
<title><anchor id="gtk-print-settings-get-quality" role="function" condition="since:2.10"/>gtk_print_settings_get_quality ()</title>
1040
<indexterm role="2.10"><primary>gtk_print_settings_get_quality</primary></indexterm><programlisting><link linkend="GtkPrintQuality">GtkPrintQuality</link> gtk_print_settings_get_quality (<link linkend="GtkPrintSettings">GtkPrintSettings</link> *settings);</programlisting>
1042
Gets the value of <link linkend="GTK-PRINT-SETTINGS-QUALITY:CAPS"><literal>GTK_PRINT_SETTINGS_QUALITY</literal></link>.</para>
1045
</para><variablelist role="params">
1046
<varlistentry><term><parameter>settings</parameter> :</term>
1047
<listitem><simpara> a <link linkend="GtkPrintSettings"><type>GtkPrintSettings</type></link>
1048
</simpara></listitem></varlistentry>
1049
<varlistentry><term><emphasis>Returns</emphasis> :</term><listitem><simpara> the print quality
1051
</simpara></listitem></varlistentry>
1052
</variablelist><para role="since">Since 2.10
1055
<title><anchor id="gtk-print-settings-set-quality" role="function" condition="since:2.10"/>gtk_print_settings_set_quality ()</title>
1056
<indexterm role="2.10"><primary>gtk_print_settings_set_quality</primary></indexterm><programlisting><link linkend="void">void</link> gtk_print_settings_set_quality (<link linkend="GtkPrintSettings">GtkPrintSettings</link> *settings,
1057
<link linkend="GtkPrintQuality">GtkPrintQuality</link> quality);</programlisting>
1059
Sets the value of <link linkend="GTK-PRINT-SETTINGS-QUALITY:CAPS"><literal>GTK_PRINT_SETTINGS_QUALITY</literal></link>.</para>
1062
</para><variablelist role="params">
1063
<varlistentry><term><parameter>settings</parameter> :</term>
1064
<listitem><simpara> a <link linkend="GtkPrintSettings"><type>GtkPrintSettings</type></link>
1065
</simpara></listitem></varlistentry>
1066
<varlistentry><term><parameter>quality</parameter> :</term>
1067
<listitem><simpara> a <link linkend="GtkPrintQuality"><type>GtkPrintQuality</type></link> value
1068
</simpara></listitem></varlistentry>
1069
</variablelist><para role="since">Since 2.10
1072
<title><anchor id="GTK-PRINT-SETTINGS-N-COPIES:CAPS" role="macro"/>GTK_PRINT_SETTINGS_N_COPIES</title>
1073
<indexterm><primary>GTK_PRINT_SETTINGS_N_COPIES</primary></indexterm><programlisting>#define GTK_PRINT_SETTINGS_N_COPIES "n-copies"
1079
<title><anchor id="gtk-print-settings-get-n-copies" role="function" condition="since:2.10"/>gtk_print_settings_get_n_copies ()</title>
1080
<indexterm role="2.10"><primary>gtk_print_settings_get_n_copies</primary></indexterm><programlisting><link linkend="gint">gint</link> gtk_print_settings_get_n_copies (<link linkend="GtkPrintSettings">GtkPrintSettings</link> *settings);</programlisting>
1082
Gets the value of <link linkend="GTK-PRINT-SETTINGS-N-COPIES:CAPS"><literal>GTK_PRINT_SETTINGS_N_COPIES</literal></link>.</para>
1085
</para><variablelist role="params">
1086
<varlistentry><term><parameter>settings</parameter> :</term>
1087
<listitem><simpara> a <link linkend="GtkPrintSettings"><type>GtkPrintSettings</type></link>
1088
</simpara></listitem></varlistentry>
1089
<varlistentry><term><emphasis>Returns</emphasis> :</term><listitem><simpara> the number of copies to print
1091
</simpara></listitem></varlistentry>
1092
</variablelist><para role="since">Since 2.10
1095
<title><anchor id="gtk-print-settings-set-n-copies" role="function" condition="since:2.10"/>gtk_print_settings_set_n_copies ()</title>
1096
<indexterm role="2.10"><primary>gtk_print_settings_set_n_copies</primary></indexterm><programlisting><link linkend="void">void</link> gtk_print_settings_set_n_copies (<link linkend="GtkPrintSettings">GtkPrintSettings</link> *settings,
1097
<link linkend="gint">gint</link> num_copies);</programlisting>
1099
Sets the value of <link linkend="GTK-PRINT-SETTINGS-N-COPIES:CAPS"><literal>GTK_PRINT_SETTINGS_N_COPIES</literal></link>.</para>
1102
</para><variablelist role="params">
1103
<varlistentry><term><parameter>settings</parameter> :</term>
1104
<listitem><simpara> a <link linkend="GtkPrintSettings"><type>GtkPrintSettings</type></link>
1105
</simpara></listitem></varlistentry>
1106
<varlistentry><term><parameter>num_copies</parameter> :</term>
1107
<listitem><simpara> the number of copies
1108
</simpara></listitem></varlistentry>
1109
</variablelist><para role="since">Since 2.10
1112
<title><anchor id="GTK-PRINT-SETTINGS-NUMBER-UP:CAPS" role="macro"/>GTK_PRINT_SETTINGS_NUMBER_UP</title>
1113
<indexterm><primary>GTK_PRINT_SETTINGS_NUMBER_UP</primary></indexterm><programlisting>#define GTK_PRINT_SETTINGS_NUMBER_UP "number-up"
1119
<title><anchor id="gtk-print-settings-get-number-up" role="function" condition="since:2.10"/>gtk_print_settings_get_number_up ()</title>
1120
<indexterm role="2.10"><primary>gtk_print_settings_get_number_up</primary></indexterm><programlisting><link linkend="gint">gint</link> gtk_print_settings_get_number_up (<link linkend="GtkPrintSettings">GtkPrintSettings</link> *settings);</programlisting>
1122
Gets the value of <link linkend="GTK-PRINT-SETTINGS-NUMBER-UP:CAPS"><literal>GTK_PRINT_SETTINGS_NUMBER_UP</literal></link>.</para>
1125
</para><variablelist role="params">
1126
<varlistentry><term><parameter>settings</parameter> :</term>
1127
<listitem><simpara> a <link linkend="GtkPrintSettings"><type>GtkPrintSettings</type></link>
1128
</simpara></listitem></varlistentry>
1129
<varlistentry><term><emphasis>Returns</emphasis> :</term><listitem><simpara> the number of pages per sheet
1131
</simpara></listitem></varlistentry>
1132
</variablelist><para role="since">Since 2.10
1135
<title><anchor id="gtk-print-settings-set-number-up" role="function" condition="since:2.10"/>gtk_print_settings_set_number_up ()</title>
1136
<indexterm role="2.10"><primary>gtk_print_settings_set_number_up</primary></indexterm><programlisting><link linkend="void">void</link> gtk_print_settings_set_number_up (<link linkend="GtkPrintSettings">GtkPrintSettings</link> *settings,
1137
<link linkend="gint">gint</link> number_up);</programlisting>
1139
Sets the value of <link linkend="GTK-PRINT-SETTINGS-NUMBER-UP:CAPS"><literal>GTK_PRINT_SETTINGS_NUMBER_UP</literal></link>.</para>
1142
</para><variablelist role="params">
1143
<varlistentry><term><parameter>settings</parameter> :</term>
1144
<listitem><simpara> a <link linkend="GtkPrintSettings"><type>GtkPrintSettings</type></link>
1145
</simpara></listitem></varlistentry>
1146
<varlistentry><term><parameter>number_up</parameter> :</term>
1147
<listitem><simpara> the number of pages per sheet
1148
</simpara></listitem></varlistentry>
1149
</variablelist><para role="since">Since 2.10
1152
<title><anchor id="GTK-PRINT-SETTINGS-RESOLUTION:CAPS" role="macro"/>GTK_PRINT_SETTINGS_RESOLUTION</title>
1153
<indexterm><primary>GTK_PRINT_SETTINGS_RESOLUTION</primary></indexterm><programlisting>#define GTK_PRINT_SETTINGS_RESOLUTION "resolution"
1159
<title><anchor id="gtk-print-settings-get-resolution" role="function" condition="since:2.10"/>gtk_print_settings_get_resolution ()</title>
1160
<indexterm role="2.10"><primary>gtk_print_settings_get_resolution</primary></indexterm><programlisting><link linkend="gint">gint</link> gtk_print_settings_get_resolution (<link linkend="GtkPrintSettings">GtkPrintSettings</link> *settings);</programlisting>
1162
Gets the value of <link linkend="GTK-PRINT-SETTINGS-RESOLUTION:CAPS"><literal>GTK_PRINT_SETTINGS_RESOLUTION</literal></link>.</para>
1165
</para><variablelist role="params">
1166
<varlistentry><term><parameter>settings</parameter> :</term>
1167
<listitem><simpara> a <link linkend="GtkPrintSettings"><type>GtkPrintSettings</type></link>
1168
</simpara></listitem></varlistentry>
1169
<varlistentry><term><emphasis>Returns</emphasis> :</term><listitem><simpara> the resolution in dpi
1171
</simpara></listitem></varlistentry>
1172
</variablelist><para role="since">Since 2.10
1175
<title><anchor id="gtk-print-settings-set-resolution" role="function" condition="since:2.10"/>gtk_print_settings_set_resolution ()</title>
1176
<indexterm role="2.10"><primary>gtk_print_settings_set_resolution</primary></indexterm><programlisting><link linkend="void">void</link> gtk_print_settings_set_resolution (<link linkend="GtkPrintSettings">GtkPrintSettings</link> *settings,
1177
<link linkend="gint">gint</link> resolution);</programlisting>
1179
Sets the value of <link linkend="GTK-PRINT-SETTINGS-RESOLUTION:CAPS"><literal>GTK_PRINT_SETTINGS_RESOLUTION</literal></link>.</para>
1182
</para><variablelist role="params">
1183
<varlistentry><term><parameter>settings</parameter> :</term>
1184
<listitem><simpara> a <link linkend="GtkPrintSettings"><type>GtkPrintSettings</type></link>
1185
</simpara></listitem></varlistentry>
1186
<varlistentry><term><parameter>resolution</parameter> :</term>
1187
<listitem><simpara> the resolution in dpi
1188
</simpara></listitem></varlistentry>
1189
</variablelist><para role="since">Since 2.10
1192
<title><anchor id="GTK-PRINT-SETTINGS-SCALE:CAPS" role="macro"/>GTK_PRINT_SETTINGS_SCALE</title>
1193
<indexterm><primary>GTK_PRINT_SETTINGS_SCALE</primary></indexterm><programlisting>#define GTK_PRINT_SETTINGS_SCALE "scale"
1199
<title><anchor id="gtk-print-settings-get-scale" role="function" condition="since:2.10"/>gtk_print_settings_get_scale ()</title>
1200
<indexterm role="2.10"><primary>gtk_print_settings_get_scale</primary></indexterm><programlisting><link linkend="gdouble">gdouble</link> gtk_print_settings_get_scale (<link linkend="GtkPrintSettings">GtkPrintSettings</link> *settings);</programlisting>
1202
Gets the value of <link linkend="GTK-PRINT-SETTINGS-SCALE:CAPS"><literal>GTK_PRINT_SETTINGS_SCALE</literal></link>.</para>
1205
</para><variablelist role="params">
1206
<varlistentry><term><parameter>settings</parameter> :</term>
1207
<listitem><simpara> a <link linkend="GtkPrintSettings"><type>GtkPrintSettings</type></link>
1208
</simpara></listitem></varlistentry>
1209
<varlistentry><term><emphasis>Returns</emphasis> :</term><listitem><simpara> the scale in percent
1211
</simpara></listitem></varlistentry>
1212
</variablelist><para role="since">Since 2.10
1215
<title><anchor id="gtk-print-settings-set-scale" role="function" condition="since:2.10"/>gtk_print_settings_set_scale ()</title>
1216
<indexterm role="2.10"><primary>gtk_print_settings_set_scale</primary></indexterm><programlisting><link linkend="void">void</link> gtk_print_settings_set_scale (<link linkend="GtkPrintSettings">GtkPrintSettings</link> *settings,
1217
<link linkend="gdouble">gdouble</link> scale);</programlisting>
1219
Sets the value of <link linkend="GTK-PRINT-SETTINGS-SCALE:CAPS"><literal>GTK_PRINT_SETTINGS_SCALE</literal></link>.</para>
1222
</para><variablelist role="params">
1223
<varlistentry><term><parameter>settings</parameter> :</term>
1224
<listitem><simpara> a <link linkend="GtkPrintSettings"><type>GtkPrintSettings</type></link>
1225
</simpara></listitem></varlistentry>
1226
<varlistentry><term><parameter>scale</parameter> :</term>
1227
<listitem><simpara> the scale in percent
1228
</simpara></listitem></varlistentry>
1229
</variablelist><para role="since">Since 2.10
1232
<title><anchor id="GtkPrintPages" role="enum"/>enum GtkPrintPages</title>
1233
<indexterm><primary>GtkPrintPages</primary></indexterm><programlisting>typedef enum {
1234
GTK_PRINT_PAGES_ALL,
1235
GTK_PRINT_PAGES_CURRENT,
1236
GTK_PRINT_PAGES_RANGES
1243
<title><anchor id="GTK-PRINT-SETTINGS-PRINT-PAGES:CAPS" role="macro"/>GTK_PRINT_SETTINGS_PRINT_PAGES</title>
1244
<indexterm><primary>GTK_PRINT_SETTINGS_PRINT_PAGES</primary></indexterm><programlisting>#define GTK_PRINT_SETTINGS_PRINT_PAGES "print-pages"
1250
<title><anchor id="gtk-print-settings-get-print-pages" role="function" condition="since:2.10"/>gtk_print_settings_get_print_pages ()</title>
1251
<indexterm role="2.10"><primary>gtk_print_settings_get_print_pages</primary></indexterm><programlisting><link linkend="GtkPrintPages">GtkPrintPages</link> gtk_print_settings_get_print_pages (<link linkend="GtkPrintSettings">GtkPrintSettings</link> *settings);</programlisting>
1253
Gets the value of <link linkend="GTK-PRINT-SETTINGS-PRINT-PAGES:CAPS"><literal>GTK_PRINT_SETTINGS_PRINT_PAGES</literal></link>.</para>
1256
</para><variablelist role="params">
1257
<varlistentry><term><parameter>settings</parameter> :</term>
1258
<listitem><simpara> a <link linkend="GtkPrintSettings"><type>GtkPrintSettings</type></link>
1259
</simpara></listitem></varlistentry>
1260
<varlistentry><term><emphasis>Returns</emphasis> :</term><listitem><simpara> which pages to print
1262
</simpara></listitem></varlistentry>
1263
</variablelist><para role="since">Since 2.10
1266
<title><anchor id="gtk-print-settings-set-print-pages" role="function" condition="since:2.10"/>gtk_print_settings_set_print_pages ()</title>
1267
<indexterm role="2.10"><primary>gtk_print_settings_set_print_pages</primary></indexterm><programlisting><link linkend="void">void</link> gtk_print_settings_set_print_pages (<link linkend="GtkPrintSettings">GtkPrintSettings</link> *settings,
1268
<link linkend="GtkPrintPages">GtkPrintPages</link> pages);</programlisting>
1270
Sets the value of <link linkend="GTK-PRINT-SETTINGS-PRINT-PAGES:CAPS"><literal>GTK_PRINT_SETTINGS_PRINT_PAGES</literal></link>.</para>
1273
</para><variablelist role="params">
1274
<varlistentry><term><parameter>settings</parameter> :</term>
1275
<listitem><simpara> a <link linkend="GtkPrintSettings"><type>GtkPrintSettings</type></link>
1276
</simpara></listitem></varlistentry>
1277
<varlistentry><term><parameter>pages</parameter> :</term>
1278
<listitem><simpara> a <link linkend="GtkPrintPages"><type>GtkPrintPages</type></link> value
1279
</simpara></listitem></varlistentry>
1280
</variablelist><para role="since">Since 2.10
1283
<title><anchor id="GtkPageRange" role="struct"/>GtkPageRange</title>
1284
<indexterm><primary>GtkPageRange</primary></indexterm><programlisting>typedef struct {
1293
<title><anchor id="GTK-PRINT-SETTINGS-PAGE-RANGES:CAPS" role="macro"/>GTK_PRINT_SETTINGS_PAGE_RANGES</title>
1294
<indexterm><primary>GTK_PRINT_SETTINGS_PAGE_RANGES</primary></indexterm><programlisting>#define GTK_PRINT_SETTINGS_PAGE_RANGES "page-ranges"
1300
<title><anchor id="gtk-print-settings-get-page-ranges" role="function" condition="since:2.10"/>gtk_print_settings_get_page_ranges ()</title>
1301
<indexterm role="2.10"><primary>gtk_print_settings_get_page_ranges</primary></indexterm><programlisting><link linkend="GtkPageRange">GtkPageRange</link>* gtk_print_settings_get_page_ranges (<link linkend="GtkPrintSettings">GtkPrintSettings</link> *settings,
1302
<link linkend="gint">gint</link> *num_ranges);</programlisting>
1304
Gets the value of <link linkend="GTK-PRINT-SETTINGS-PAGE-RANGES:CAPS"><literal>GTK_PRINT_SETTINGS_PAGE_RANGES</literal></link>.</para>
1307
</para><variablelist role="params">
1308
<varlistentry><term><parameter>settings</parameter> :</term>
1309
<listitem><simpara> a <link linkend="GtkPrintSettings"><type>GtkPrintSettings</type></link>
1310
</simpara></listitem></varlistentry>
1311
<varlistentry><term><parameter>num_ranges</parameter> :</term>
1312
<listitem><simpara> return location for the length of the returned array
1313
</simpara></listitem></varlistentry>
1314
<varlistentry><term><emphasis>Returns</emphasis> :</term><listitem><simpara> an array of <link linkend="GtkPageRange"><type>GtkPageRange</type></link><!-- -->s. Use <link linkend="g-free"><function>g_free()</function></link>
1315
to free the array when it is no longer needed.
1317
</simpara></listitem></varlistentry>
1318
</variablelist><para role="since">Since 2.10
1321
<title><anchor id="gtk-print-settings-set-page-ranges" role="function" condition="since:2.10"/>gtk_print_settings_set_page_ranges ()</title>
1322
<indexterm role="2.10"><primary>gtk_print_settings_set_page_ranges</primary></indexterm><programlisting><link linkend="void">void</link> gtk_print_settings_set_page_ranges (<link linkend="GtkPrintSettings">GtkPrintSettings</link> *settings,
1323
<link linkend="GtkPageRange">GtkPageRange</link> *page_ranges,
1324
<link linkend="gint">gint</link> num_ranges);</programlisting>
1326
Sets the value of <link linkend="GTK-PRINT-SETTINGS-PAGE-RANGES:CAPS"><literal>GTK_PRINT_SETTINGS_PAGE_RANGES</literal></link>.</para>
1329
</para><variablelist role="params">
1330
<varlistentry><term><parameter>settings</parameter> :</term>
1331
<listitem><simpara> a <link linkend="GtkPrintSettings"><type>GtkPrintSettings</type></link>
1332
</simpara></listitem></varlistentry>
1333
<varlistentry><term><parameter>page_ranges</parameter> :</term>
1334
<listitem><simpara> an array of <link linkend="GtkPageRange"><type>GtkPageRange</type></link><!-- -->s
1335
</simpara></listitem></varlistentry>
1336
<varlistentry><term><parameter>num_ranges</parameter> :</term>
1337
<listitem><simpara> the length of <parameter>page_ranges</parameter>
1338
</simpara></listitem></varlistentry>
1339
</variablelist><para role="since">Since 2.10
1342
<title><anchor id="GtkPageSet" role="enum"/>enum GtkPageSet</title>
1343
<indexterm><primary>GtkPageSet</primary></indexterm><programlisting>typedef enum {
1353
<title><anchor id="GTK-PRINT-SETTINGS-PAGE-SET:CAPS" role="macro"/>GTK_PRINT_SETTINGS_PAGE_SET</title>
1354
<indexterm><primary>GTK_PRINT_SETTINGS_PAGE_SET</primary></indexterm><programlisting>#define GTK_PRINT_SETTINGS_PAGE_SET "page-set"
1360
<title><anchor id="gtk-print-settings-get-page-set" role="function" condition="since:2.10"/>gtk_print_settings_get_page_set ()</title>
1361
<indexterm role="2.10"><primary>gtk_print_settings_get_page_set</primary></indexterm><programlisting><link linkend="GtkPageSet">GtkPageSet</link> gtk_print_settings_get_page_set (<link linkend="GtkPrintSettings">GtkPrintSettings</link> *settings);</programlisting>
1363
Gets the value of <link linkend="GTK-PRINT-SETTINGS-PAGE-SET:CAPS"><literal>GTK_PRINT_SETTINGS_PAGE_SET</literal></link>.</para>
1366
</para><variablelist role="params">
1367
<varlistentry><term><parameter>settings</parameter> :</term>
1368
<listitem><simpara> a <link linkend="GtkPrintSettings"><type>GtkPrintSettings</type></link>
1369
</simpara></listitem></varlistentry>
1370
<varlistentry><term><emphasis>Returns</emphasis> :</term><listitem><simpara> the set of pages to print
1372
</simpara></listitem></varlistentry>
1373
</variablelist><para role="since">Since 2.10
1376
<title><anchor id="gtk-print-settings-set-page-set" role="function" condition="since:2.10"/>gtk_print_settings_set_page_set ()</title>
1377
<indexterm role="2.10"><primary>gtk_print_settings_set_page_set</primary></indexterm><programlisting><link linkend="void">void</link> gtk_print_settings_set_page_set (<link linkend="GtkPrintSettings">GtkPrintSettings</link> *settings,
1378
<link linkend="GtkPageSet">GtkPageSet</link> page_set);</programlisting>
1380
Sets the value of <link linkend="GTK-PRINT-SETTINGS-PAGE-SET:CAPS"><literal>GTK_PRINT_SETTINGS_PAGE_SET</literal></link>.</para>
1383
</para><variablelist role="params">
1384
<varlistentry><term><parameter>settings</parameter> :</term>
1385
<listitem><simpara> a <link linkend="GtkPrintSettings"><type>GtkPrintSettings</type></link>
1386
</simpara></listitem></varlistentry>
1387
<varlistentry><term><parameter>page_set</parameter> :</term>
1388
<listitem><simpara> a <link linkend="GtkPageSet"><type>GtkPageSet</type></link> value
1389
</simpara></listitem></varlistentry>
1390
</variablelist><para role="since">Since 2.10
1393
<title><anchor id="GTK-PRINT-SETTINGS-DEFAULT-SOURCE:CAPS" role="macro"/>GTK_PRINT_SETTINGS_DEFAULT_SOURCE</title>
1394
<indexterm><primary>GTK_PRINT_SETTINGS_DEFAULT_SOURCE</primary></indexterm><programlisting>#define GTK_PRINT_SETTINGS_DEFAULT_SOURCE "default-source"
1400
<title><anchor id="gtk-print-settings-get-default-source" role="function" condition="since:2.10"/>gtk_print_settings_get_default_source ()</title>
1401
<indexterm role="2.10"><primary>gtk_print_settings_get_default_source</primary></indexterm><programlisting>const <link linkend="gchar">gchar</link>* gtk_print_settings_get_default_source
1402
(<link linkend="GtkPrintSettings">GtkPrintSettings</link> *settings);</programlisting>
1404
Gets the value of <link linkend="GTK-PRINT-SETTINGS-DEFAULT-SOURCE:CAPS"><literal>GTK_PRINT_SETTINGS_DEFAULT_SOURCE</literal></link>.</para>
1407
</para><variablelist role="params">
1408
<varlistentry><term><parameter>settings</parameter> :</term>
1409
<listitem><simpara> a <link linkend="GtkPrintSettings"><type>GtkPrintSettings</type></link>
1410
</simpara></listitem></varlistentry>
1411
<varlistentry><term><emphasis>Returns</emphasis> :</term><listitem><simpara> the default source
1413
</simpara></listitem></varlistentry>
1414
</variablelist><para role="since">Since 2.10
1417
<title><anchor id="gtk-print-settings-set-default-source" role="function" condition="since:2.10"/>gtk_print_settings_set_default_source ()</title>
1418
<indexterm role="2.10"><primary>gtk_print_settings_set_default_source</primary></indexterm><programlisting><link linkend="void">void</link> gtk_print_settings_set_default_source
1419
(<link linkend="GtkPrintSettings">GtkPrintSettings</link> *settings,
1420
const <link linkend="gchar">gchar</link> *default_source);</programlisting>
1422
Sets the value of <link linkend="GTK-PRINT-SETTINGS-DEFAULT-SOURCE:CAPS"><literal>GTK_PRINT_SETTINGS_DEFAULT_SOURCE</literal></link>.</para>
1425
</para><variablelist role="params">
1426
<varlistentry><term><parameter>settings</parameter> :</term>
1427
<listitem><simpara> a <link linkend="GtkPrintSettings"><type>GtkPrintSettings</type></link>
1428
</simpara></listitem></varlistentry>
1429
<varlistentry><term><parameter>default_source</parameter> :</term>
1430
<listitem><simpara> the default source
1431
</simpara></listitem></varlistentry>
1432
</variablelist><para role="since">Since 2.10
1435
<title><anchor id="GTK-PRINT-SETTINGS-MEDIA-TYPE:CAPS" role="macro"/>GTK_PRINT_SETTINGS_MEDIA_TYPE</title>
1436
<indexterm><primary>GTK_PRINT_SETTINGS_MEDIA_TYPE</primary></indexterm><programlisting>#define GTK_PRINT_SETTINGS_MEDIA_TYPE "media-type"
1442
<title><anchor id="gtk-print-settings-get-media-type" role="function" condition="since:2.10"/>gtk_print_settings_get_media_type ()</title>
1443
<indexterm role="2.10"><primary>gtk_print_settings_get_media_type</primary></indexterm><programlisting>const <link linkend="gchar">gchar</link>* gtk_print_settings_get_media_type (<link linkend="GtkPrintSettings">GtkPrintSettings</link> *settings);</programlisting>
1445
Gets the value of <link linkend="GTK-PRINT-SETTINGS-MEDIA-TYPE:CAPS"><literal>GTK_PRINT_SETTINGS_MEDIA_TYPE</literal></link>.
1448
The set of media types is defined in PWG 5101.1-2002 PWG.
1449
<!-- FIXME link here --></para>
1452
</para><variablelist role="params">
1453
<varlistentry><term><parameter>settings</parameter> :</term>
1454
<listitem><simpara> a <link linkend="GtkPrintSettings"><type>GtkPrintSettings</type></link>
1455
</simpara></listitem></varlistentry>
1456
<varlistentry><term><emphasis>Returns</emphasis> :</term><listitem><simpara> the media type
1458
</simpara></listitem></varlistentry>
1459
</variablelist><para role="since">Since 2.10
1462
<title><anchor id="gtk-print-settings-set-media-type" role="function" condition="since:2.10"/>gtk_print_settings_set_media_type ()</title>
1463
<indexterm role="2.10"><primary>gtk_print_settings_set_media_type</primary></indexterm><programlisting><link linkend="void">void</link> gtk_print_settings_set_media_type (<link linkend="GtkPrintSettings">GtkPrintSettings</link> *settings,
1464
const <link linkend="gchar">gchar</link> *media_type);</programlisting>
1466
Sets the value of <link linkend="GTK-PRINT-SETTINGS-MEDIA-TYPE:CAPS"><literal>GTK_PRINT_SETTINGS_MEDIA_TYPE</literal></link>.
1469
The set of media types is defined in PWG 5101.1-2002 PWG.
1470
<!-- FIXME link here --></para>
1473
</para><variablelist role="params">
1474
<varlistentry><term><parameter>settings</parameter> :</term>
1475
<listitem><simpara> a <link linkend="GtkPrintSettings"><type>GtkPrintSettings</type></link>
1476
</simpara></listitem></varlistentry>
1477
<varlistentry><term><parameter>media_type</parameter> :</term>
1478
<listitem><simpara> the media type
1479
</simpara></listitem></varlistentry>
1480
</variablelist><para role="since">Since 2.10
1483
<title><anchor id="GTK-PRINT-SETTINGS-DITHER:CAPS" role="macro"/>GTK_PRINT_SETTINGS_DITHER</title>
1484
<indexterm><primary>GTK_PRINT_SETTINGS_DITHER</primary></indexterm><programlisting>#define GTK_PRINT_SETTINGS_DITHER "dither"
1490
<title><anchor id="gtk-print-settings-get-dither" role="function" condition="since:2.10"/>gtk_print_settings_get_dither ()</title>
1491
<indexterm role="2.10"><primary>gtk_print_settings_get_dither</primary></indexterm><programlisting>const <link linkend="gchar">gchar</link>* gtk_print_settings_get_dither (<link linkend="GtkPrintSettings">GtkPrintSettings</link> *settings);</programlisting>
1493
Gets the value of <link linkend="GTK-PRINT-SETTINGS-DITHER:CAPS"><literal>GTK_PRINT_SETTINGS_DITHER</literal></link>.</para>
1496
</para><variablelist role="params">
1497
<varlistentry><term><parameter>settings</parameter> :</term>
1498
<listitem><simpara> a <link linkend="GtkPrintSettings"><type>GtkPrintSettings</type></link>
1499
</simpara></listitem></varlistentry>
1500
<varlistentry><term><emphasis>Returns</emphasis> :</term><listitem><simpara> the dithering that is used
1502
</simpara></listitem></varlistentry>
1503
</variablelist><para role="since">Since 2.10
1506
<title><anchor id="gtk-print-settings-set-dither" role="function" condition="since:2.10"/>gtk_print_settings_set_dither ()</title>
1507
<indexterm role="2.10"><primary>gtk_print_settings_set_dither</primary></indexterm><programlisting><link linkend="void">void</link> gtk_print_settings_set_dither (<link linkend="GtkPrintSettings">GtkPrintSettings</link> *settings,
1508
const <link linkend="gchar">gchar</link> *dither);</programlisting>
1510
Sets the value of <link linkend="GTK-PRINT-SETTINGS-DITHER:CAPS"><literal>GTK_PRINT_SETTINGS_DITHER</literal></link>.</para>
1513
</para><variablelist role="params">
1514
<varlistentry><term><parameter>settings</parameter> :</term>
1515
<listitem><simpara> a <link linkend="GtkPrintSettings"><type>GtkPrintSettings</type></link>
1516
</simpara></listitem></varlistentry>
1517
<varlistentry><term><parameter>dither</parameter> :</term>
1518
<listitem><simpara> the dithering that is used
1519
</simpara></listitem></varlistentry>
1520
</variablelist><para role="since">Since 2.10
1523
<title><anchor id="GTK-PRINT-SETTINGS-FINISHINGS:CAPS" role="macro"/>GTK_PRINT_SETTINGS_FINISHINGS</title>
1524
<indexterm><primary>GTK_PRINT_SETTINGS_FINISHINGS</primary></indexterm><programlisting>#define GTK_PRINT_SETTINGS_FINISHINGS "finishings"
1530
<title><anchor id="gtk-print-settings-get-finishings" role="function" condition="since:2.10"/>gtk_print_settings_get_finishings ()</title>
1531
<indexterm role="2.10"><primary>gtk_print_settings_get_finishings</primary></indexterm><programlisting>const <link linkend="gchar">gchar</link>* gtk_print_settings_get_finishings (<link linkend="GtkPrintSettings">GtkPrintSettings</link> *settings);</programlisting>
1533
Gets the value of <link linkend="GTK-PRINT-SETTINGS-FINISHINGS:CAPS"><literal>GTK_PRINT_SETTINGS_FINISHINGS</literal></link>.</para>
1536
</para><variablelist role="params">
1537
<varlistentry><term><parameter>settings</parameter> :</term>
1538
<listitem><simpara> a <link linkend="GtkPrintSettings"><type>GtkPrintSettings</type></link>
1539
</simpara></listitem></varlistentry>
1540
<varlistentry><term><emphasis>Returns</emphasis> :</term><listitem><simpara> the finishings
1542
</simpara></listitem></varlistentry>
1543
</variablelist><para role="since">Since 2.10
1546
<title><anchor id="gtk-print-settings-set-finishings" role="function" condition="since:2.10"/>gtk_print_settings_set_finishings ()</title>
1547
<indexterm role="2.10"><primary>gtk_print_settings_set_finishings</primary></indexterm><programlisting><link linkend="void">void</link> gtk_print_settings_set_finishings (<link linkend="GtkPrintSettings">GtkPrintSettings</link> *settings,
1548
const <link linkend="gchar">gchar</link> *finishings);</programlisting>
1550
Sets the value of <link linkend="GTK-PRINT-SETTINGS-FINISHINGS:CAPS"><literal>GTK_PRINT_SETTINGS_FINISHINGS</literal></link>.</para>
1553
</para><variablelist role="params">
1554
<varlistentry><term><parameter>settings</parameter> :</term>
1555
<listitem><simpara> a <link linkend="GtkPrintSettings"><type>GtkPrintSettings</type></link>
1556
</simpara></listitem></varlistentry>
1557
<varlistentry><term><parameter>finishings</parameter> :</term>
1558
<listitem><simpara> the finishings
1559
</simpara></listitem></varlistentry>
1560
</variablelist><para role="since">Since 2.10
1563
<title><anchor id="GTK-PRINT-SETTINGS-OUTPUT-BIN:CAPS" role="macro"/>GTK_PRINT_SETTINGS_OUTPUT_BIN</title>
1564
<indexterm><primary>GTK_PRINT_SETTINGS_OUTPUT_BIN</primary></indexterm><programlisting>#define GTK_PRINT_SETTINGS_OUTPUT_BIN "output-bin"
1570
<title><anchor id="gtk-print-settings-get-output-bin" role="function" condition="since:2.10"/>gtk_print_settings_get_output_bin ()</title>
1571
<indexterm role="2.10"><primary>gtk_print_settings_get_output_bin</primary></indexterm><programlisting>const <link linkend="gchar">gchar</link>* gtk_print_settings_get_output_bin (<link linkend="GtkPrintSettings">GtkPrintSettings</link> *settings);</programlisting>
1573
Gets the value of <link linkend="GTK-PRINT-SETTINGS-OUTPUT-BIN:CAPS"><literal>GTK_PRINT_SETTINGS_OUTPUT_BIN</literal></link>.</para>
1576
</para><variablelist role="params">
1577
<varlistentry><term><parameter>settings</parameter> :</term>
1578
<listitem><simpara> a <link linkend="GtkPrintSettings"><type>GtkPrintSettings</type></link>
1579
</simpara></listitem></varlistentry>
1580
<varlistentry><term><emphasis>Returns</emphasis> :</term><listitem><simpara> the output bin
1582
</simpara></listitem></varlistentry>
1583
</variablelist><para role="since">Since 2.10
1586
<title><anchor id="gtk-print-settings-set-output-bin" role="function" condition="since:2.10"/>gtk_print_settings_set_output_bin ()</title>
1587
<indexterm role="2.10"><primary>gtk_print_settings_set_output_bin</primary></indexterm><programlisting><link linkend="void">void</link> gtk_print_settings_set_output_bin (<link linkend="GtkPrintSettings">GtkPrintSettings</link> *settings,
1588
const <link linkend="gchar">gchar</link> *output_bin);</programlisting>
1590
Sets the value of <link linkend="GTK-PRINT-SETTINGS-OUTPUT-BIN:CAPS"><literal>GTK_PRINT_SETTINGS_OUTPUT_BIN</literal></link>.</para>
1593
</para><variablelist role="params">
1594
<varlistentry><term><parameter>settings</parameter> :</term>
1595
<listitem><simpara> a <link linkend="GtkPrintSettings"><type>GtkPrintSettings</type></link>
1596
</simpara></listitem></varlistentry>
1597
<varlistentry><term><parameter>output_bin</parameter> :</term>
1598
<listitem><simpara> the output bin
1599
</simpara></listitem></varlistentry>
1600
</variablelist><para role="since">Since 2.10
1603
<title><anchor id="GTK-PRINT-SETTINGS-OUTPUT-FILE-FORMAT:CAPS" role="macro"/>GTK_PRINT_SETTINGS_OUTPUT_FILE_FORMAT</title>
1604
<indexterm><primary>GTK_PRINT_SETTINGS_OUTPUT_FILE_FORMAT</primary></indexterm><programlisting>#define GTK_PRINT_SETTINGS_OUTPUT_FILE_FORMAT "output-file-format"
1607
The key used by the "Print to file" printer to store the format
1608
of the output. The supported values are "PS" and "PDF".
1611
<title><anchor id="GTK-PRINT-SETTINGS-OUTPUT-URI:CAPS" role="macro"/>GTK_PRINT_SETTINGS_OUTPUT_URI</title>
1612
<indexterm><primary>GTK_PRINT_SETTINGS_OUTPUT_URI</primary></indexterm><programlisting>#define GTK_PRINT_SETTINGS_OUTPUT_URI "output-uri"
1615
The key used by the "Print to file" printer to store the URI
1616
to which the output should be written. GTK+ itself supports
1617
only "file://" URIs.
1620
<title><anchor id="GTK-PRINT-SETTINGS-WIN32-DRIVER-EXTRA:CAPS" role="macro"/>GTK_PRINT_SETTINGS_WIN32_DRIVER_EXTRA</title>
1621
<indexterm><primary>GTK_PRINT_SETTINGS_WIN32_DRIVER_EXTRA</primary></indexterm><programlisting>#define GTK_PRINT_SETTINGS_WIN32_DRIVER_EXTRA "win32-driver-extra"
1627
<title><anchor id="GTK-PRINT-SETTINGS-WIN32-DRIVER-VERSION:CAPS" role="macro"/>GTK_PRINT_SETTINGS_WIN32_DRIVER_VERSION</title>
1628
<indexterm><primary>GTK_PRINT_SETTINGS_WIN32_DRIVER_VERSION</primary></indexterm><programlisting>#define GTK_PRINT_SETTINGS_WIN32_DRIVER_VERSION "win32-driver-version"