1
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
4
<meta http-equiv="Content-Type" content="text/html; charset=US-ASCII">
5
<title>GtkPageSetup</title>
6
<meta name="generator" content="DocBook XSL Stylesheets V1.72.0">
7
<link rel="start" href="index.html" title="GTK+ Reference Manual">
8
<link rel="up" href="Printing.html" title="Printing">
9
<link rel="prev" href="GtkPrintSettings.html" title="GtkPrintSettings">
10
<link rel="next" href="gtk-GtkPaperSize.html" title="GtkPaperSize">
11
<meta name="generator" content="GTK-Doc V1.7 (XML mode)">
12
<link rel="stylesheet" href="style.css" type="text/css">
13
<link rel="part" href="gtk.html" title="Part I. GTK+ Overview">
14
<link rel="part" href="gtkbase.html" title="Part II. GTK+ Core Reference">
15
<link rel="part" href="gtkobjects.html" title="Part III. GTK+ Widgets and Objects">
16
<link rel="chapter" href="ch01.html" title="Object Hierarchy">
17
<link rel="chapter" href="ch02.html" title="Widget Gallery">
18
<link rel="chapter" href="WindowWidgets.html" title="Windows">
19
<link rel="chapter" href="DisplayWidgets.html" title="Display Widgets">
20
<link rel="chapter" href="ButtonWidgets.html" title="Buttons and Toggles">
21
<link rel="chapter" href="NumericEntry.html" title="Numeric/Text Data Entry">
22
<link rel="chapter" href="TextWidgetObjects.html" title="Multiline Text Editor">
23
<link rel="chapter" href="TreeWidgetObjects.html" title="Tree, List and Icon Grid Widgets">
24
<link rel="chapter" href="MenusAndCombos.html" title="Menus, Combo Box, Toolbar">
25
<link rel="chapter" href="Actions.html" title="Action-based menus and toolbars">
26
<link rel="chapter" href="SelectorWidgets.html" title="Selectors (File/Font/Color/Input Devices)">
27
<link rel="chapter" href="LayoutContainers.html" title="Layout Containers">
28
<link rel="chapter" href="Ornaments.html" title="Ornaments">
29
<link rel="chapter" href="ScrollingWidgets.html" title="Scrolling">
30
<link rel="chapter" href="Printing.html" title="Printing">
31
<link rel="chapter" href="MiscObjects.html" title="Miscellaneous">
32
<link rel="chapter" href="AbstractObjects.html" title="Abstract Base Classes">
33
<link rel="chapter" href="PlugSocket.html" title="Cross-process Embedding">
34
<link rel="chapter" href="SpecialObjects.html" title="Special-purpose features">
35
<link rel="chapter" href="RecentDocuments.html" title="Recently Used Documents">
36
<link rel="chapter" href="DeprecatedObjects.html" title="Deprecated">
37
<link rel="part" href="migrating.html" title="Part IV. Migrating from Previous Versions of GTK+">
38
<link rel="chapter" href="gtk-migrating-checklist.html" title="Migration Checklist">
39
<link rel="chapter" href="gtk-migrating-GtkFileChooser.html" title="Migrating from GtkFileSelection to GtkFileChooser">
40
<link rel="chapter" href="gtk-migrating-GtkAction.html" title="Migrating from old menu and toolbar systems to GtkAction">
41
<link rel="chapter" href="gtk-migrating-GtkComboBox.html" title="Migrating from GtkOptionMenu and GtkCombo to GtkComboBox and GtkComboBoxEntry">
42
<link rel="chapter" href="gtk-migrating-GtkIconView.html" title="Migrating from GnomeIconList to GtkIconView">
43
<link rel="chapter" href="gtk-migrating-GtkAboutDialog.html" title="Migrating from GnomeAbout to GtkAboutDialog">
44
<link rel="chapter" href="gtk-migrating-GtkColorButton.html" title="Migrating from GnomeColorPicker to GtkColorButton">
45
<link rel="chapter" href="gtk-migrating-GtkAssistant.html" title="Migrating from GnomeDruid to GtkAssistant">
46
<link rel="chapter" href="gtk-migrating-GtkRecentChooser.html" title="Migrating from EggRecent to GtkRecentChooser">
47
<link rel="chapter" href="gtk-migrating-GtkLinkButton.html" title="Migrating from GnomeHRef to GtkLinkButton">
48
<link rel="part" href="pt05.html" title="Part V. GTK+ Tools">
49
<link rel="glossary" href="glossary.html" title="Glossary">
50
<link rel="index" href="ix01.html" title="Index">
51
<link rel="index" href="ix02.html" title="Index of deprecated symbols">
52
<link rel="index" href="ix03.html" title="Index of new symbols in 2.2">
53
<link rel="index" href="ix04.html" title="Index of new symbols in 2.4">
54
<link rel="index" href="ix05.html" title="Index of new symbols in 2.6">
55
<link rel="index" href="ix06.html" title="Index of new symbols in 2.8">
56
<link rel="index" href="ix07.html" title="Index of new symbols in 2.10">
58
<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
59
<table class="navigation" id="top" width="100%" summary="Navigation header" cellpadding="2" cellspacing="2">
61
<td><a accesskey="p" href="GtkPrintSettings.html"><img src="left.png" width="24" height="24" border="0" alt="Prev"></a></td>
62
<td><a accesskey="u" href="Printing.html"><img src="up.png" width="24" height="24" border="0" alt="Up"></a></td>
63
<td><a accesskey="h" href="index.html"><img src="home.png" width="24" height="24" border="0" alt="Home"></a></td>
64
<th width="100%" align="center">GTK+ Reference Manual</th>
65
<td><a accesskey="n" href="gtk-GtkPaperSize.html"><img src="right.png" width="24" height="24" border="0" alt="Next"></a></td>
67
<tr><td colspan="5" class="shortcuts"><nobr><a href="#id3621843" class="shortcut">Top</a>
69
<a href="#id3622482" class="shortcut">Description</a>
71
<a href="#id3622458" class="shortcut">Object Hierarchy</a></nobr></td></tr>
73
<div class="refentry" lang="en">
74
<a name="GtkPageSetup"></a><div class="titlepage"></div>
75
<div class="refnamediv"><table width="100%"><tr>
78
<a name="id3621843"></a><span class="refentrytitle">GtkPageSetup</span>
80
<p>GtkPageSetup — Stores page setup information</p>
82
<td valign="top" align="right"></td>
84
<div class="refsynopsisdiv">
86
<pre class="synopsis">
88
#include <gtk/gtk.h>
91
<a href="GtkPageSetup.html#GtkPageSetup-struct">GtkPageSetup</a>;
92
<a href="GtkPageSetup.html" title="GtkPageSetup">GtkPageSetup</a>* <a href="GtkPageSetup.html#gtk-page-setup-new">gtk_page_setup_new</a> (void);
93
<a href="GtkPageSetup.html" title="GtkPageSetup">GtkPageSetup</a>* <a href="GtkPageSetup.html#gtk-page-setup-copy">gtk_page_setup_copy</a> (<a href="GtkPageSetup.html" title="GtkPageSetup">GtkPageSetup</a> *other);
94
<a href="GtkPrintSettings.html#GtkPageOrientation">GtkPageOrientation</a> <a href="GtkPageSetup.html#gtk-page-setup-get-orientation">gtk_page_setup_get_orientation</a> (<a href="GtkPageSetup.html" title="GtkPageSetup">GtkPageSetup</a> *setup);
95
void <a href="GtkPageSetup.html#gtk-page-setup-set-orientation">gtk_page_setup_set_orientation</a> (<a href="GtkPageSetup.html" title="GtkPageSetup">GtkPageSetup</a> *setup,
96
<a href="GtkPrintSettings.html#GtkPageOrientation">GtkPageOrientation</a> orientation);
97
<a href="gtk-GtkPaperSize.html#GtkPaperSize">GtkPaperSize</a>* <a href="GtkPageSetup.html#gtk-page-setup-get-paper-size">gtk_page_setup_get_paper_size</a> (<a href="GtkPageSetup.html" title="GtkPageSetup">GtkPageSetup</a> *setup);
98
void <a href="GtkPageSetup.html#gtk-page-setup-set-paper-size">gtk_page_setup_set_paper_size</a> (<a href="GtkPageSetup.html" title="GtkPageSetup">GtkPageSetup</a> *setup,
99
<a href="gtk-GtkPaperSize.html#GtkPaperSize">GtkPaperSize</a> *size);
100
gdouble <a href="GtkPageSetup.html#gtk-page-setup-get-top-margin">gtk_page_setup_get_top_margin</a> (<a href="GtkPageSetup.html" title="GtkPageSetup">GtkPageSetup</a> *setup,
101
<a href="gtk-GtkPaperSize.html#GtkUnit">GtkUnit</a> unit);
102
void <a href="GtkPageSetup.html#gtk-page-setup-set-top-margin">gtk_page_setup_set_top_margin</a> (<a href="GtkPageSetup.html" title="GtkPageSetup">GtkPageSetup</a> *setup,
104
<a href="gtk-GtkPaperSize.html#GtkUnit">GtkUnit</a> unit);
105
gdouble <a href="GtkPageSetup.html#gtk-page-setup-get-bottom-margin">gtk_page_setup_get_bottom_margin</a> (<a href="GtkPageSetup.html" title="GtkPageSetup">GtkPageSetup</a> *setup,
106
<a href="gtk-GtkPaperSize.html#GtkUnit">GtkUnit</a> unit);
107
void <a href="GtkPageSetup.html#gtk-page-setup-set-bottom-margin">gtk_page_setup_set_bottom_margin</a> (<a href="GtkPageSetup.html" title="GtkPageSetup">GtkPageSetup</a> *setup,
109
<a href="gtk-GtkPaperSize.html#GtkUnit">GtkUnit</a> unit);
110
gdouble <a href="GtkPageSetup.html#gtk-page-setup-get-left-margin">gtk_page_setup_get_left_margin</a> (<a href="GtkPageSetup.html" title="GtkPageSetup">GtkPageSetup</a> *setup,
111
<a href="gtk-GtkPaperSize.html#GtkUnit">GtkUnit</a> unit);
112
void <a href="GtkPageSetup.html#gtk-page-setup-set-left-margin">gtk_page_setup_set_left_margin</a> (<a href="GtkPageSetup.html" title="GtkPageSetup">GtkPageSetup</a> *setup,
114
<a href="gtk-GtkPaperSize.html#GtkUnit">GtkUnit</a> unit);
115
gdouble <a href="GtkPageSetup.html#gtk-page-setup-get-right-margin">gtk_page_setup_get_right_margin</a> (<a href="GtkPageSetup.html" title="GtkPageSetup">GtkPageSetup</a> *setup,
116
<a href="gtk-GtkPaperSize.html#GtkUnit">GtkUnit</a> unit);
117
void <a href="GtkPageSetup.html#gtk-page-setup-set-right-margin">gtk_page_setup_set_right_margin</a> (<a href="GtkPageSetup.html" title="GtkPageSetup">GtkPageSetup</a> *setup,
119
<a href="gtk-GtkPaperSize.html#GtkUnit">GtkUnit</a> unit);
120
void <a href="GtkPageSetup.html#gtk-page-setup-set-paper-size-and-default-margins">gtk_page_setup_set_paper_size_and_default_margins</a>
121
(<a href="GtkPageSetup.html" title="GtkPageSetup">GtkPageSetup</a> *setup,
122
<a href="gtk-GtkPaperSize.html#GtkPaperSize">GtkPaperSize</a> *size);
123
gdouble <a href="GtkPageSetup.html#gtk-page-setup-get-paper-width">gtk_page_setup_get_paper_width</a> (<a href="GtkPageSetup.html" title="GtkPageSetup">GtkPageSetup</a> *setup,
124
<a href="gtk-GtkPaperSize.html#GtkUnit">GtkUnit</a> unit);
125
gdouble <a href="GtkPageSetup.html#gtk-page-setup-get-paper-height">gtk_page_setup_get_paper_height</a> (<a href="GtkPageSetup.html" title="GtkPageSetup">GtkPageSetup</a> *setup,
126
<a href="gtk-GtkPaperSize.html#GtkUnit">GtkUnit</a> unit);
127
gdouble <a href="GtkPageSetup.html#gtk-page-setup-get-page-width">gtk_page_setup_get_page_width</a> (<a href="GtkPageSetup.html" title="GtkPageSetup">GtkPageSetup</a> *setup,
128
<a href="gtk-GtkPaperSize.html#GtkUnit">GtkUnit</a> unit);
129
gdouble <a href="GtkPageSetup.html#gtk-page-setup-get-page-height">gtk_page_setup_get_page_height</a> (<a href="GtkPageSetup.html" title="GtkPageSetup">GtkPageSetup</a> *setup,
130
<a href="gtk-GtkPaperSize.html#GtkUnit">GtkUnit</a> unit);
135
<div class="refsect1" lang="en">
136
<a name="id3622458"></a><h2>Object Hierarchy</h2>
137
<pre class="synopsis">
143
<div class="refsect1" lang="en">
144
<a name="id3622482"></a><h2>Description</h2>
146
A GtkPageSetup object stores the page size, orientation and margins.
147
The idea is that you can get one of these from the page setup dialog
148
and then pass it to the <a href="gtk-High-level-Printing-API.html#GtkPrintOperation"><span class="type">GtkPrintOperation</span></a> when printing.
149
The benefit of splitting this out of the <a href="GtkPrintSettings.html" title="GtkPrintSettings"><span class="type">GtkPrintSettings</span></a> is that
150
these affect the actual layout of the page, and thus need to be set
151
long before user prints.
153
<p><a name="print-margins"></a>
154
The margins specified in this object are the "print margins", i.e. the
155
parts of the page that the printer cannot print on. These are different
156
from the layout margins that a word processor uses; they are typically
157
used to determine the <span class="emphasis"><em>minimal</em></span> size for the layout
161
To obtain a <a href="GtkPageSetup.html" title="GtkPageSetup"><span class="type">GtkPageSetup</span></a> use <a href="GtkPageSetup.html#gtk-page-setup-new"><code class="function">gtk_page_setup_new()</code></a>
162
to get the defaults, or use <a href="gtk-High-level-Printing-API.html#gtk-print-run-page-setup-dialog"><code class="function">gtk_print_run_page_setup_dialog()</code></a> to show
163
the page setup dialog and receive the resulting page setup.
165
<div class="example">
166
<a name="id3622569"></a><p class="title"><b>Example 32. A page setup dialog</b></p>
167
<div class="example-contents"><pre class="programlisting">
168
static GtkPrintSettings *settings = NULL;
169
static GtkPageSetup *page_setup = NULL;
174
GtkPageSetup *new_page_setup;
176
if (settings == NULL)
177
settings = gtk_print_settings_new ();
179
new_page_setup = gtk_print_run_page_setup_dialog (GTK_WINDOW (main_window),
180
page_setup, settings);
183
g_object_unref (page_setup);
185
page_setup = new_page_setup;
189
<br class="example-break"><p>
190
Printing support was added in GTK+ 2.10.
193
<div class="refsect1" lang="en">
194
<a name="id3622597"></a><h2>Details</h2>
195
<div class="refsect2" lang="en">
196
<a name="id3622607"></a><h3>
197
<a name="GtkPageSetup-struct"></a>GtkPageSetup</h3>
198
<a class="indexterm" name="id3622620"></a><pre class="programlisting">typedef struct _GtkPageSetup GtkPageSetup;</pre>
204
<div class="refsect2" lang="en">
205
<a name="id3622636"></a><h3>
206
<a name="gtk-page-setup-new"></a>gtk_page_setup_new ()</h3>
207
<a class="indexterm" name="id3622652"></a><pre class="programlisting"><a href="GtkPageSetup.html" title="GtkPageSetup">GtkPageSetup</a>* gtk_page_setup_new (void);</pre>
209
Creates a new <a href="GtkPageSetup.html" title="GtkPageSetup"><span class="type">GtkPageSetup</span></a>.</p>
213
<div class="variablelist"><table border="0">
214
<col align="left" valign="top">
216
<td><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
217
<td> a new <a href="GtkPageSetup.html" title="GtkPageSetup"><span class="type">GtkPageSetup</span></a>.
222
<p class="since">Since 2.10
226
<div class="refsect2" lang="en">
227
<a name="id3622714"></a><h3>
228
<a name="gtk-page-setup-copy"></a>gtk_page_setup_copy ()</h3>
229
<a class="indexterm" name="id3622730"></a><pre class="programlisting"><a href="GtkPageSetup.html" title="GtkPageSetup">GtkPageSetup</a>* gtk_page_setup_copy (<a href="GtkPageSetup.html" title="GtkPageSetup">GtkPageSetup</a> *other);</pre>
231
Copies a <a href="GtkPageSetup.html" title="GtkPageSetup"><span class="type">GtkPageSetup</span></a>.</p>
235
<div class="variablelist"><table border="0">
236
<col align="left" valign="top">
239
<td><span class="term"><em class="parameter"><code>other</code></em> :</span></td>
240
<td> the <a href="GtkPageSetup.html" title="GtkPageSetup"><span class="type">GtkPageSetup</span></a> to copy
244
<td><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
245
<td> a copy of <em class="parameter"><code>other</code></em>
251
<p class="since">Since 2.10
255
<div class="refsect2" lang="en">
256
<a name="id3622820"></a><h3>
257
<a name="gtk-page-setup-get-orientation"></a>gtk_page_setup_get_orientation ()</h3>
258
<a class="indexterm" name="id3622836"></a><pre class="programlisting"><a href="GtkPrintSettings.html#GtkPageOrientation">GtkPageOrientation</a> gtk_page_setup_get_orientation (<a href="GtkPageSetup.html" title="GtkPageSetup">GtkPageSetup</a> *setup);</pre>
260
Gets the page orientation of the <a href="GtkPageSetup.html" title="GtkPageSetup"><span class="type">GtkPageSetup</span></a>.</p>
264
<div class="variablelist"><table border="0">
265
<col align="left" valign="top">
268
<td><span class="term"><em class="parameter"><code>setup</code></em> :</span></td>
269
<td> a <a href="GtkPageSetup.html" title="GtkPageSetup"><span class="type">GtkPageSetup</span></a>
273
<td><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
274
<td> the page orientation
280
<p class="since">Since 2.10
284
<div class="refsect2" lang="en">
285
<a name="id3622921"></a><h3>
286
<a name="gtk-page-setup-set-orientation"></a>gtk_page_setup_set_orientation ()</h3>
287
<a class="indexterm" name="id3622937"></a><pre class="programlisting">void gtk_page_setup_set_orientation (<a href="GtkPageSetup.html" title="GtkPageSetup">GtkPageSetup</a> *setup,
288
<a href="GtkPrintSettings.html#GtkPageOrientation">GtkPageOrientation</a> orientation);</pre>
290
Sets the page orientation of the <a href="GtkPageSetup.html" title="GtkPageSetup"><span class="type">GtkPageSetup</span></a>.</p>
294
<div class="variablelist"><table border="0">
295
<col align="left" valign="top">
298
<td><span class="term"><em class="parameter"><code>setup</code></em> :</span></td>
299
<td> a <a href="GtkPageSetup.html" title="GtkPageSetup"><span class="type">GtkPageSetup</span></a>
303
<td><span class="term"><em class="parameter"><code>orientation</code></em> :</span></td>
304
<td> a <a href="GtkPrintSettings.html#GtkPageOrientation"><span class="type">GtkPageOrientation</span></a> value
309
<p class="since">Since 2.10
313
<div class="refsect2" lang="en">
314
<a name="id3623041"></a><h3>
315
<a name="gtk-page-setup-get-paper-size"></a>gtk_page_setup_get_paper_size ()</h3>
316
<a class="indexterm" name="id3623057"></a><pre class="programlisting"><a href="gtk-GtkPaperSize.html#GtkPaperSize">GtkPaperSize</a>* gtk_page_setup_get_paper_size (<a href="GtkPageSetup.html" title="GtkPageSetup">GtkPageSetup</a> *setup);</pre>
318
Gets the paper size of the <a href="GtkPageSetup.html" title="GtkPageSetup"><span class="type">GtkPageSetup</span></a>.</p>
322
<div class="variablelist"><table border="0">
323
<col align="left" valign="top">
326
<td><span class="term"><em class="parameter"><code>setup</code></em> :</span></td>
327
<td> a <a href="GtkPageSetup.html" title="GtkPageSetup"><span class="type">GtkPageSetup</span></a>
331
<td><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
338
<p class="since">Since 2.10
342
<div class="refsect2" lang="en">
343
<a name="id3623141"></a><h3>
344
<a name="gtk-page-setup-set-paper-size"></a>gtk_page_setup_set_paper_size ()</h3>
345
<a class="indexterm" name="id3623157"></a><pre class="programlisting">void gtk_page_setup_set_paper_size (<a href="GtkPageSetup.html" title="GtkPageSetup">GtkPageSetup</a> *setup,
346
<a href="gtk-GtkPaperSize.html#GtkPaperSize">GtkPaperSize</a> *size);</pre>
348
Sets the paper size of the <a href="GtkPageSetup.html" title="GtkPageSetup"><span class="type">GtkPageSetup</span></a> without
349
changing the margins. See
350
<a href="GtkPageSetup.html#gtk-page-setup-set-paper-size-and-default-margins"><code class="function">gtk_page_setup_set_paper_size_and_default_margins()</code></a>.</p>
354
<div class="variablelist"><table border="0">
355
<col align="left" valign="top">
358
<td><span class="term"><em class="parameter"><code>setup</code></em> :</span></td>
359
<td> a <a href="GtkPageSetup.html" title="GtkPageSetup"><span class="type">GtkPageSetup</span></a>
363
<td><span class="term"><em class="parameter"><code>size</code></em> :</span></td>
364
<td> a <a href="gtk-GtkPaperSize.html#GtkPaperSize"><span class="type">GtkPaperSize</span></a>
369
<p class="since">Since 2.10
373
<div class="refsect2" lang="en">
374
<a name="id3623274"></a><h3>
375
<a name="gtk-page-setup-get-top-margin"></a>gtk_page_setup_get_top_margin ()</h3>
376
<a class="indexterm" name="id3623290"></a><pre class="programlisting">gdouble gtk_page_setup_get_top_margin (<a href="GtkPageSetup.html" title="GtkPageSetup">GtkPageSetup</a> *setup,
377
<a href="gtk-GtkPaperSize.html#GtkUnit">GtkUnit</a> unit);</pre>
379
Gets the top margin in units of <em class="parameter"><code>unit</code></em>.</p>
383
<div class="variablelist"><table border="0">
384
<col align="left" valign="top">
387
<td><span class="term"><em class="parameter"><code>setup</code></em> :</span></td>
388
<td> a <a href="GtkPageSetup.html" title="GtkPageSetup"><span class="type">GtkPageSetup</span></a>
392
<td><span class="term"><em class="parameter"><code>unit</code></em> :</span></td>
393
<td> the unit for the return value
397
<td><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
404
<p class="since">Since 2.10
408
<div class="refsect2" lang="en">
409
<a name="id3623394"></a><h3>
410
<a name="gtk-page-setup-set-top-margin"></a>gtk_page_setup_set_top_margin ()</h3>
411
<a class="indexterm" name="id3623410"></a><pre class="programlisting">void gtk_page_setup_set_top_margin (<a href="GtkPageSetup.html" title="GtkPageSetup">GtkPageSetup</a> *setup,
413
<a href="gtk-GtkPaperSize.html#GtkUnit">GtkUnit</a> unit);</pre>
415
Sets the top margin of the <a href="GtkPageSetup.html" title="GtkPageSetup"><span class="type">GtkPageSetup</span></a>.</p>
419
<div class="variablelist"><table border="0">
420
<col align="left" valign="top">
423
<td><span class="term"><em class="parameter"><code>setup</code></em> :</span></td>
424
<td> a <a href="GtkPageSetup.html" title="GtkPageSetup"><span class="type">GtkPageSetup</span></a>
428
<td><span class="term"><em class="parameter"><code>margin</code></em> :</span></td>
429
<td> the new top margin in units of <em class="parameter"><code>unit</code></em>
433
<td><span class="term"><em class="parameter"><code>unit</code></em> :</span></td>
434
<td> the units for <em class="parameter"><code>margin</code></em>
439
<p class="since">Since 2.10
443
<div class="refsect2" lang="en">
444
<a name="id3623539"></a><h3>
445
<a name="gtk-page-setup-get-bottom-margin"></a>gtk_page_setup_get_bottom_margin ()</h3>
446
<a class="indexterm" name="id3623555"></a><pre class="programlisting">gdouble gtk_page_setup_get_bottom_margin (<a href="GtkPageSetup.html" title="GtkPageSetup">GtkPageSetup</a> *setup,
447
<a href="gtk-GtkPaperSize.html#GtkUnit">GtkUnit</a> unit);</pre>
449
Gets the bottom margin in units of <em class="parameter"><code>unit</code></em>.</p>
453
<div class="variablelist"><table border="0">
454
<col align="left" valign="top">
457
<td><span class="term"><em class="parameter"><code>setup</code></em> :</span></td>
458
<td> a <a href="GtkPageSetup.html" title="GtkPageSetup"><span class="type">GtkPageSetup</span></a>
462
<td><span class="term"><em class="parameter"><code>unit</code></em> :</span></td>
463
<td> the unit for the return value
467
<td><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
468
<td> the bottom margin
474
<p class="since">Since 2.10
478
<div class="refsect2" lang="en">
479
<a name="id3623659"></a><h3>
480
<a name="gtk-page-setup-set-bottom-margin"></a>gtk_page_setup_set_bottom_margin ()</h3>
481
<a class="indexterm" name="id3623675"></a><pre class="programlisting">void gtk_page_setup_set_bottom_margin (<a href="GtkPageSetup.html" title="GtkPageSetup">GtkPageSetup</a> *setup,
483
<a href="gtk-GtkPaperSize.html#GtkUnit">GtkUnit</a> unit);</pre>
485
Sets the bottom margin of the <a href="GtkPageSetup.html" title="GtkPageSetup"><span class="type">GtkPageSetup</span></a>.</p>
489
<div class="variablelist"><table border="0">
490
<col align="left" valign="top">
493
<td><span class="term"><em class="parameter"><code>setup</code></em> :</span></td>
494
<td> a <a href="GtkPageSetup.html" title="GtkPageSetup"><span class="type">GtkPageSetup</span></a>
498
<td><span class="term"><em class="parameter"><code>margin</code></em> :</span></td>
499
<td> the new bottom margin in units of <em class="parameter"><code>unit</code></em>
503
<td><span class="term"><em class="parameter"><code>unit</code></em> :</span></td>
504
<td> the units for <em class="parameter"><code>margin</code></em>
509
<p class="since">Since 2.10
513
<div class="refsect2" lang="en">
514
<a name="id3623804"></a><h3>
515
<a name="gtk-page-setup-get-left-margin"></a>gtk_page_setup_get_left_margin ()</h3>
516
<a class="indexterm" name="id3623820"></a><pre class="programlisting">gdouble gtk_page_setup_get_left_margin (<a href="GtkPageSetup.html" title="GtkPageSetup">GtkPageSetup</a> *setup,
517
<a href="gtk-GtkPaperSize.html#GtkUnit">GtkUnit</a> unit);</pre>
519
Gets the left margin in units of <em class="parameter"><code>unit</code></em>.</p>
523
<div class="variablelist"><table border="0">
524
<col align="left" valign="top">
527
<td><span class="term"><em class="parameter"><code>setup</code></em> :</span></td>
528
<td> a <a href="GtkPageSetup.html" title="GtkPageSetup"><span class="type">GtkPageSetup</span></a>
532
<td><span class="term"><em class="parameter"><code>unit</code></em> :</span></td>
533
<td> the unit for the return value
537
<td><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
544
<p class="since">Since 2.10
548
<div class="refsect2" lang="en">
549
<a name="id3623924"></a><h3>
550
<a name="gtk-page-setup-set-left-margin"></a>gtk_page_setup_set_left_margin ()</h3>
551
<a class="indexterm" name="id3623940"></a><pre class="programlisting">void gtk_page_setup_set_left_margin (<a href="GtkPageSetup.html" title="GtkPageSetup">GtkPageSetup</a> *setup,
553
<a href="gtk-GtkPaperSize.html#GtkUnit">GtkUnit</a> unit);</pre>
555
Sets the left margin of the <a href="GtkPageSetup.html" title="GtkPageSetup"><span class="type">GtkPageSetup</span></a>.</p>
559
<div class="variablelist"><table border="0">
560
<col align="left" valign="top">
563
<td><span class="term"><em class="parameter"><code>setup</code></em> :</span></td>
564
<td> a <a href="GtkPageSetup.html" title="GtkPageSetup"><span class="type">GtkPageSetup</span></a>
568
<td><span class="term"><em class="parameter"><code>margin</code></em> :</span></td>
569
<td> the new left margin in units of <em class="parameter"><code>unit</code></em>
573
<td><span class="term"><em class="parameter"><code>unit</code></em> :</span></td>
574
<td> the units for <em class="parameter"><code>margin</code></em>
579
<p class="since">Since 2.10
583
<div class="refsect2" lang="en">
584
<a name="id3624069"></a><h3>
585
<a name="gtk-page-setup-get-right-margin"></a>gtk_page_setup_get_right_margin ()</h3>
586
<a class="indexterm" name="id3624085"></a><pre class="programlisting">gdouble gtk_page_setup_get_right_margin (<a href="GtkPageSetup.html" title="GtkPageSetup">GtkPageSetup</a> *setup,
587
<a href="gtk-GtkPaperSize.html#GtkUnit">GtkUnit</a> unit);</pre>
589
Gets the right margin in units of <em class="parameter"><code>unit</code></em>.</p>
593
<div class="variablelist"><table border="0">
594
<col align="left" valign="top">
597
<td><span class="term"><em class="parameter"><code>setup</code></em> :</span></td>
598
<td> a <a href="GtkPageSetup.html" title="GtkPageSetup"><span class="type">GtkPageSetup</span></a>
602
<td><span class="term"><em class="parameter"><code>unit</code></em> :</span></td>
603
<td> the unit for the return value
607
<td><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
608
<td> the right margin
614
<p class="since">Since 2.10
618
<div class="refsect2" lang="en">
619
<a name="id3624189"></a><h3>
620
<a name="gtk-page-setup-set-right-margin"></a>gtk_page_setup_set_right_margin ()</h3>
621
<a class="indexterm" name="id3624205"></a><pre class="programlisting">void gtk_page_setup_set_right_margin (<a href="GtkPageSetup.html" title="GtkPageSetup">GtkPageSetup</a> *setup,
623
<a href="gtk-GtkPaperSize.html#GtkUnit">GtkUnit</a> unit);</pre>
625
Sets the right margin of the <a href="GtkPageSetup.html" title="GtkPageSetup"><span class="type">GtkPageSetup</span></a>.</p>
629
<div class="variablelist"><table border="0">
630
<col align="left" valign="top">
633
<td><span class="term"><em class="parameter"><code>setup</code></em> :</span></td>
634
<td> a <a href="GtkPageSetup.html" title="GtkPageSetup"><span class="type">GtkPageSetup</span></a>
638
<td><span class="term"><em class="parameter"><code>margin</code></em> :</span></td>
639
<td> the new right margin in units of <em class="parameter"><code>unit</code></em>
643
<td><span class="term"><em class="parameter"><code>unit</code></em> :</span></td>
644
<td> the units for <em class="parameter"><code>margin</code></em>
649
<p class="since">Since 2.10
653
<div class="refsect2" lang="en">
654
<a name="id3624335"></a><h3>
655
<a name="gtk-page-setup-set-paper-size-and-default-margins"></a>gtk_page_setup_set_paper_size_and_default_margins ()</h3>
656
<a class="indexterm" name="id3624352"></a><pre class="programlisting">void gtk_page_setup_set_paper_size_and_default_margins
657
(<a href="GtkPageSetup.html" title="GtkPageSetup">GtkPageSetup</a> *setup,
658
<a href="gtk-GtkPaperSize.html#GtkPaperSize">GtkPaperSize</a> *size);</pre>
660
Sets the paper size of the <a href="GtkPageSetup.html" title="GtkPageSetup"><span class="type">GtkPageSetup</span></a> and modifies
661
the margins according to the new paper size.</p>
665
<div class="variablelist"><table border="0">
666
<col align="left" valign="top">
669
<td><span class="term"><em class="parameter"><code>setup</code></em> :</span></td>
670
<td> a <a href="GtkPageSetup.html" title="GtkPageSetup"><span class="type">GtkPageSetup</span></a>
674
<td><span class="term"><em class="parameter"><code>size</code></em> :</span></td>
675
<td> a <a href="gtk-GtkPaperSize.html#GtkPaperSize"><span class="type">GtkPaperSize</span></a>
680
<p class="since">Since 2.10
684
<div class="refsect2" lang="en">
685
<a name="id3624458"></a><h3>
686
<a name="gtk-page-setup-get-paper-width"></a>gtk_page_setup_get_paper_width ()</h3>
687
<a class="indexterm" name="id3624474"></a><pre class="programlisting">gdouble gtk_page_setup_get_paper_width (<a href="GtkPageSetup.html" title="GtkPageSetup">GtkPageSetup</a> *setup,
688
<a href="gtk-GtkPaperSize.html#GtkUnit">GtkUnit</a> unit);</pre>
690
Returns the paper width in units of <em class="parameter"><code>unit</code></em>.
693
Note that this function takes orientation, but
694
not margins into consideration.
695
See <a href="GtkPageSetup.html#gtk-page-setup-get-page-width"><code class="function">gtk_page_setup_get_page_width()</code></a>.</p>
699
<div class="variablelist"><table border="0">
700
<col align="left" valign="top">
703
<td><span class="term"><em class="parameter"><code>setup</code></em> :</span></td>
704
<td> a <a href="GtkPageSetup.html" title="GtkPageSetup"><span class="type">GtkPageSetup</span></a>
708
<td><span class="term"><em class="parameter"><code>unit</code></em> :</span></td>
709
<td> the unit for the return value
713
<td><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
714
<td> the paper width.
720
<p class="since">Since 2.10
724
<div class="refsect2" lang="en">
725
<a name="id3624594"></a><h3>
726
<a name="gtk-page-setup-get-paper-height"></a>gtk_page_setup_get_paper_height ()</h3>
727
<a class="indexterm" name="id3624610"></a><pre class="programlisting">gdouble gtk_page_setup_get_paper_height (<a href="GtkPageSetup.html" title="GtkPageSetup">GtkPageSetup</a> *setup,
728
<a href="gtk-GtkPaperSize.html#GtkUnit">GtkUnit</a> unit);</pre>
730
Returns the paper height in units of <em class="parameter"><code>unit</code></em>.
733
Note that this function takes orientation, but
734
not margins into consideration.
735
See <a href="GtkPageSetup.html#gtk-page-setup-get-page-height"><code class="function">gtk_page_setup_get_page_height()</code></a>.</p>
739
<div class="variablelist"><table border="0">
740
<col align="left" valign="top">
743
<td><span class="term"><em class="parameter"><code>setup</code></em> :</span></td>
744
<td> a <a href="GtkPageSetup.html" title="GtkPageSetup"><span class="type">GtkPageSetup</span></a>
748
<td><span class="term"><em class="parameter"><code>unit</code></em> :</span></td>
749
<td> the unit for the return value
753
<td><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
754
<td> the paper height.
760
<p class="since">Since 2.10
764
<div class="refsect2" lang="en">
765
<a name="id3624730"></a><h3>
766
<a name="gtk-page-setup-get-page-width"></a>gtk_page_setup_get_page_width ()</h3>
767
<a class="indexterm" name="id3624746"></a><pre class="programlisting">gdouble gtk_page_setup_get_page_width (<a href="GtkPageSetup.html" title="GtkPageSetup">GtkPageSetup</a> *setup,
768
<a href="gtk-GtkPaperSize.html#GtkUnit">GtkUnit</a> unit);</pre>
770
Returns the page width in units of <em class="parameter"><code>unit</code></em>.
773
Note that this function takes orientation and
774
margins into consideration.
775
See <a href="GtkPageSetup.html#gtk-page-setup-get-paper-width"><code class="function">gtk_page_setup_get_paper_width()</code></a>.</p>
779
<div class="variablelist"><table border="0">
780
<col align="left" valign="top">
783
<td><span class="term"><em class="parameter"><code>setup</code></em> :</span></td>
784
<td> a <a href="GtkPageSetup.html" title="GtkPageSetup"><span class="type">GtkPageSetup</span></a>
788
<td><span class="term"><em class="parameter"><code>unit</code></em> :</span></td>
789
<td> the unit for the return value
793
<td><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
800
<p class="since">Since 2.10
804
<div class="refsect2" lang="en">
805
<a name="id3624866"></a><h3>
806
<a name="gtk-page-setup-get-page-height"></a>gtk_page_setup_get_page_height ()</h3>
807
<a class="indexterm" name="id3624882"></a><pre class="programlisting">gdouble gtk_page_setup_get_page_height (<a href="GtkPageSetup.html" title="GtkPageSetup">GtkPageSetup</a> *setup,
808
<a href="gtk-GtkPaperSize.html#GtkUnit">GtkUnit</a> unit);</pre>
810
Returns the page height in units of <em class="parameter"><code>unit</code></em>.
813
Note that this function takes orientation and
814
margins into consideration.
815
See <a href="GtkPageSetup.html#gtk-page-setup-get-paper-height"><code class="function">gtk_page_setup_get_paper_height()</code></a>.</p>
819
<div class="variablelist"><table border="0">
820
<col align="left" valign="top">
823
<td><span class="term"><em class="parameter"><code>setup</code></em> :</span></td>
824
<td> a <a href="GtkPageSetup.html" title="GtkPageSetup"><span class="type">GtkPageSetup</span></a>
828
<td><span class="term"><em class="parameter"><code>unit</code></em> :</span></td>
829
<td> the unit for the return value
833
<td><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
834
<td> the page height.
840
<p class="since">Since 2.10