← Back to branch summary

~inkscape.dev/inkscape-devlibs/devlibs-gtk3

« back to all changes in this revision

Viewing changes to share/gtk-doc/html/gtk2/GtkPrinter.html

  • Committer: JazzyNico
  • Date: 2013-01-21 10:11:05 UTC
  • Revision ID: nicoduf@yahoo.fr-20130121101105-i8d8slkq9ng4olx8
Adding gtk2 libraries.

Show diffs side-by-side

added added

removed removed

Lines of Context:
share/gtk-doc/html/gtk2/GtkPrinter.html
 
1
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
 
2
<html>
 
3
<head>
 
4
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
 
5
<title>GtkPrinter</title>
 
6
<meta name="generator" content="DocBook XSL Stylesheets V1.77.1">
 
7
<link rel="home" href="index.html" title="GTK+ 2 Reference Manual">
 
8
<link rel="up" href="Printing.html" title="Printing">
 
9
<link rel="prev" href="GtkPaperSize.html" title="GtkPaperSize">
 
10
<link rel="next" href="GtkPrintJob.html" title="GtkPrintJob">
 
11
<meta name="generator" content="GTK-Doc V1.18 (XML mode)">
 
12
<link rel="stylesheet" href="style.css" type="text/css">
 
13
</head>
 
14
<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
 
15
<table class="navigation" id="top" width="100%" summary="Navigation header" cellpadding="2" cellspacing="2">
 
16
<tr valign="middle">
 
17
<td><a accesskey="p" href="GtkPaperSize.html"><img src="left.png" width="24" height="24" border="0" alt="Prev"></a></td>
 
18
<td><a accesskey="u" href="Printing.html"><img src="up.png" width="24" height="24" border="0" alt="Up"></a></td>
 
19
<td><a accesskey="h" href="index.html"><img src="home.png" width="24" height="24" border="0" alt="Home"></a></td>
 
20
<th width="100%" align="center">GTK+ 2 Reference Manual</th>
 
21
<td><a accesskey="n" href="GtkPrintJob.html"><img src="right.png" width="24" height="24" border="0" alt="Next"></a></td>
 
22
</tr>
 
23
<tr><td colspan="5" class="shortcuts">
 
24
<a href="#GtkPrinter.synopsis" class="shortcut">Top</a>
 
25
                   | 
 
26
                  <a href="#GtkPrinter.description" class="shortcut">Description</a>
 
27
                   | 
 
28
                  <a href="#GtkPrinter.object-hierarchy" class="shortcut">Object Hierarchy</a>
 
29
                   | 
 
30
                  <a href="#GtkPrinter.properties" class="shortcut">Properties</a>
 
31
                   | 
 
32
                  <a href="#GtkPrinter.signals" class="shortcut">Signals</a>
 
33
</td></tr>
 
34
</table>
 
35
<div class="refentry">
 
36
<a name="GtkPrinter"></a><div class="titlepage"></div>
 
37
<div class="refnamediv"><table width="100%"><tr>
 
38
<td valign="top">
 
39
<h2><span class="refentrytitle"><a name="GtkPrinter.top_of_page"></a>GtkPrinter</span></h2>
 
40
<p>GtkPrinter — Represents a printer</p>
 
41
</td>
 
42
<td valign="top" align="right"></td>
 
43
</tr></table></div>
 
44
<div class="refsynopsisdiv">
 
45
<a name="GtkPrinter.synopsis"></a><h2>Synopsis</h2>
 
46
<a name="GtkPrintBackend"></a><pre class="synopsis">
 
47
#include &lt;gtk/gtk.h&gt;
 
48
 
 
49
struct              <a class="link" href="GtkPrinter.html#GtkPrinter-struct" title="struct GtkPrinter">GtkPrinter</a>;
 
50
                    <a class="link" href="GtkPrinter.html#GtkPrintBackend-struct" title="GtkPrintBackend">GtkPrintBackend</a>;
 
51
<a class="link" href="GtkPrinter.html" title="GtkPrinter"><span class="returnvalue">GtkPrinter</span></a> *        <a class="link" href="GtkPrinter.html#gtk-printer-new" title="gtk_printer_new ()">gtk_printer_new</a>                     (<em class="parameter"><code>const <span class="type">gchar</span> *name</code></em>,
 
52
                                                         <em class="parameter"><code><a class="link" href="GtkPrinter.html#GtkPrintBackend"><span class="type">GtkPrintBackend</span></a> *backend</code></em>,
 
53
                                                         <em class="parameter"><code><span class="type">gboolean</span> virtual_</code></em>);
 
54
<a class="link" href="GtkPrinter.html#GtkPrintBackend"><span class="returnvalue">GtkPrintBackend</span></a> *   <a class="link" href="GtkPrinter.html#gtk-printer-get-backend" title="gtk_printer_get_backend ()">gtk_printer_get_backend</a>             (<em class="parameter"><code><a class="link" href="GtkPrinter.html" title="GtkPrinter"><span class="type">GtkPrinter</span></a> *printer</code></em>);
 
55
const <span class="returnvalue">gchar</span> *       <a class="link" href="GtkPrinter.html#gtk-printer-get-name" title="gtk_printer_get_name ()">gtk_printer_get_name</a>                (<em class="parameter"><code><a class="link" href="GtkPrinter.html" title="GtkPrinter"><span class="type">GtkPrinter</span></a> *printer</code></em>);
 
56
const <span class="returnvalue">gchar</span> *       <a class="link" href="GtkPrinter.html#gtk-printer-get-state-message" title="gtk_printer_get_state_message ()">gtk_printer_get_state_message</a>       (<em class="parameter"><code><a class="link" href="GtkPrinter.html" title="GtkPrinter"><span class="type">GtkPrinter</span></a> *printer</code></em>);
 
57
const <span class="returnvalue">gchar</span> *       <a class="link" href="GtkPrinter.html#gtk-printer-get-description" title="gtk_printer_get_description ()">gtk_printer_get_description</a>         (<em class="parameter"><code><a class="link" href="GtkPrinter.html" title="GtkPrinter"><span class="type">GtkPrinter</span></a> *printer</code></em>);
 
58
const <span class="returnvalue">gchar</span> *       <a class="link" href="GtkPrinter.html#gtk-printer-get-location" title="gtk_printer_get_location ()">gtk_printer_get_location</a>            (<em class="parameter"><code><a class="link" href="GtkPrinter.html" title="GtkPrinter"><span class="type">GtkPrinter</span></a> *printer</code></em>);
 
59
const <span class="returnvalue">gchar</span> *       <a class="link" href="GtkPrinter.html#gtk-printer-get-icon-name" title="gtk_printer_get_icon_name ()">gtk_printer_get_icon_name</a>           (<em class="parameter"><code><a class="link" href="GtkPrinter.html" title="GtkPrinter"><span class="type">GtkPrinter</span></a> *printer</code></em>);
 
60
<span class="returnvalue">gint</span>                <a class="link" href="GtkPrinter.html#gtk-printer-get-job-count" title="gtk_printer_get_job_count ()">gtk_printer_get_job_count</a>           (<em class="parameter"><code><a class="link" href="GtkPrinter.html" title="GtkPrinter"><span class="type">GtkPrinter</span></a> *printer</code></em>);
 
61
<span class="returnvalue">gboolean</span>            <a class="link" href="GtkPrinter.html#gtk-printer-is-active" title="gtk_printer_is_active ()">gtk_printer_is_active</a>               (<em class="parameter"><code><a class="link" href="GtkPrinter.html" title="GtkPrinter"><span class="type">GtkPrinter</span></a> *printer</code></em>);
 
62
<span class="returnvalue">gboolean</span>            <a class="link" href="GtkPrinter.html#gtk-printer-is-paused" title="gtk_printer_is_paused ()">gtk_printer_is_paused</a>               (<em class="parameter"><code><a class="link" href="GtkPrinter.html" title="GtkPrinter"><span class="type">GtkPrinter</span></a> *printer</code></em>);
 
63
<span class="returnvalue">gboolean</span>            <a class="link" href="GtkPrinter.html#gtk-printer-is-accepting-jobs" title="gtk_printer_is_accepting_jobs ()">gtk_printer_is_accepting_jobs</a>       (<em class="parameter"><code><a class="link" href="GtkPrinter.html" title="GtkPrinter"><span class="type">GtkPrinter</span></a> *printer</code></em>);
 
64
<span class="returnvalue">gboolean</span>            <a class="link" href="GtkPrinter.html#gtk-printer-is-virtual" title="gtk_printer_is_virtual ()">gtk_printer_is_virtual</a>              (<em class="parameter"><code><a class="link" href="GtkPrinter.html" title="GtkPrinter"><span class="type">GtkPrinter</span></a> *printer</code></em>);
 
65
<span class="returnvalue">gboolean</span>            <a class="link" href="GtkPrinter.html#gtk-printer-is-default" title="gtk_printer_is_default ()">gtk_printer_is_default</a>              (<em class="parameter"><code><a class="link" href="GtkPrinter.html" title="GtkPrinter"><span class="type">GtkPrinter</span></a> *printer</code></em>);
 
66
<span class="returnvalue">gboolean</span>            <a class="link" href="GtkPrinter.html#gtk-printer-accepts-ps" title="gtk_printer_accepts_ps ()">gtk_printer_accepts_ps</a>              (<em class="parameter"><code><a class="link" href="GtkPrinter.html" title="GtkPrinter"><span class="type">GtkPrinter</span></a> *printer</code></em>);
 
67
<span class="returnvalue">gboolean</span>            <a class="link" href="GtkPrinter.html#gtk-printer-accepts-pdf" title="gtk_printer_accepts_pdf ()">gtk_printer_accepts_pdf</a>             (<em class="parameter"><code><a class="link" href="GtkPrinter.html" title="GtkPrinter"><span class="type">GtkPrinter</span></a> *printer</code></em>);
 
68
<span class="returnvalue">GList</span> *             <a class="link" href="GtkPrinter.html#gtk-printer-list-papers" title="gtk_printer_list_papers ()">gtk_printer_list_papers</a>             (<em class="parameter"><code><a class="link" href="GtkPrinter.html" title="GtkPrinter"><span class="type">GtkPrinter</span></a> *printer</code></em>);
 
69
<span class="returnvalue">gint</span>                <a class="link" href="GtkPrinter.html#gtk-printer-compare" title="gtk_printer_compare ()">gtk_printer_compare</a>                 (<em class="parameter"><code><a class="link" href="GtkPrinter.html" title="GtkPrinter"><span class="type">GtkPrinter</span></a> *a</code></em>,
 
70
                                                         <em class="parameter"><code><a class="link" href="GtkPrinter.html" title="GtkPrinter"><span class="type">GtkPrinter</span></a> *b</code></em>);
 
71
<span class="returnvalue">gboolean</span>            <a class="link" href="GtkPrinter.html#gtk-printer-has-details" title="gtk_printer_has_details ()">gtk_printer_has_details</a>             (<em class="parameter"><code><a class="link" href="GtkPrinter.html" title="GtkPrinter"><span class="type">GtkPrinter</span></a> *printer</code></em>);
 
72
<span class="returnvalue">void</span>                <a class="link" href="GtkPrinter.html#gtk-printer-request-details" title="gtk_printer_request_details ()">gtk_printer_request_details</a>         (<em class="parameter"><code><a class="link" href="GtkPrinter.html" title="GtkPrinter"><span class="type">GtkPrinter</span></a> *printer</code></em>);
 
73
<a class="link" href="GtkPrintUnixDialog.html#GtkPrintCapabilities" title="enum GtkPrintCapabilities"><span class="returnvalue">GtkPrintCapabilities</span></a> <a class="link" href="GtkPrinter.html#gtk-printer-get-capabilities" title="gtk_printer_get_capabilities ()">gtk_printer_get_capabilities</a>       (<em class="parameter"><code><a class="link" href="GtkPrinter.html" title="GtkPrinter"><span class="type">GtkPrinter</span></a> *printer</code></em>);
 
74
<a class="link" href="GtkPageSetup.html" title="GtkPageSetup"><span class="returnvalue">GtkPageSetup</span></a> *      <a class="link" href="GtkPrinter.html#gtk-printer-get-default-page-size" title="gtk_printer_get_default_page_size ()">gtk_printer_get_default_page_size</a>   (<em class="parameter"><code><a class="link" href="GtkPrinter.html" title="GtkPrinter"><span class="type">GtkPrinter</span></a> *printer</code></em>);
 
75
<span class="returnvalue">gboolean</span>            <a class="link" href="GtkPrinter.html#gtk-printer-get-hard-margins" title="gtk_printer_get_hard_margins ()">gtk_printer_get_hard_margins</a>        (<em class="parameter"><code><a class="link" href="GtkPrinter.html" title="GtkPrinter"><span class="type">GtkPrinter</span></a> *printer</code></em>,
 
76
                                                         <em class="parameter"><code><span class="type">gdouble</span> *top</code></em>,
 
77
                                                         <em class="parameter"><code><span class="type">gdouble</span> *bottom</code></em>,
 
78
                                                         <em class="parameter"><code><span class="type">gdouble</span> *left</code></em>,
 
79
                                                         <em class="parameter"><code><span class="type">gdouble</span> *right</code></em>);
 
80
<span class="returnvalue">gboolean</span>            (<a class="link" href="GtkPrinter.html#GtkPrinterFunc" title="GtkPrinterFunc ()">*GtkPrinterFunc</a>)                   (<em class="parameter"><code><a class="link" href="GtkPrinter.html" title="GtkPrinter"><span class="type">GtkPrinter</span></a> *printer</code></em>,
 
81
                                                         <em class="parameter"><code><span class="type">gpointer</span> data</code></em>);
 
82
<span class="returnvalue">void</span>                <a class="link" href="GtkPrinter.html#gtk-enumerate-printers" title="gtk_enumerate_printers ()">gtk_enumerate_printers</a>              (<em class="parameter"><code><a class="link" href="GtkPrinter.html#GtkPrinterFunc" title="GtkPrinterFunc ()"><span class="type">GtkPrinterFunc</span></a> func</code></em>,
 
83
                                                         <em class="parameter"><code><span class="type">gpointer</span> data</code></em>,
 
84
                                                         <em class="parameter"><code><span class="type">GDestroyNotify</span> destroy</code></em>,
 
85
                                                         <em class="parameter"><code><span class="type">gboolean</span> wait</code></em>);
 
86
</pre>
 
87
</div>
 
88
<div class="refsect1">
 
89
<a name="GtkPrinter.object-hierarchy"></a><h2>Object Hierarchy</h2>
 
90
<pre class="synopsis">
 
91
  GObject
 
92
   +----GtkPrinter
 
93
</pre>
 
94
<pre class="synopsis">
 
95
  GObject
 
96
   +----GtkPrintBackend
 
97
</pre>
 
98
</div>
 
99
<div class="refsect1">
 
100
<a name="GtkPrinter.properties"></a><h2>Properties</h2>
 
101
<pre class="synopsis">
 
102
  "<a class="link" href="GtkPrinter.html#GtkPrinter--accepting-jobs" title='The "accepting-jobs" property'>accepting-jobs</a>"           <span class="type">gboolean</span>              : Read
 
103
  "<a class="link" href="GtkPrinter.html#GtkPrinter--accepts-pdf" title='The "accepts-pdf" property'>accepts-pdf</a>"              <span class="type">gboolean</span>              : Read / Write / Construct Only
 
104
  "<a class="link" href="GtkPrinter.html#GtkPrinter--accepts-ps" title='The "accepts-ps" property'>accepts-ps</a>"               <span class="type">gboolean</span>              : Read / Write / Construct Only
 
105
  "<a class="link" href="GtkPrinter.html#GtkPrinter--backend" title='The "backend" property'>backend</a>"                  <a class="link" href="GtkPrinter.html#GtkPrintBackend"><span class="type">GtkPrintBackend</span></a>*      : Read / Write / Construct Only
 
106
  "<a class="link" href="GtkPrinter.html#GtkPrinter--icon-name" title='The "icon-name" property'>icon-name</a>"                <span class="type">gchar</span>*                : Read
 
107
  "<a class="link" href="GtkPrinter.html#GtkPrinter--is-virtual" title='The "is-virtual" property'>is-virtual</a>"               <span class="type">gboolean</span>              : Read / Write / Construct Only
 
108
  "<a class="link" href="GtkPrinter.html#GtkPrinter--job-count" title='The "job-count" property'>job-count</a>"                <span class="type">gint</span>                  : Read
 
109
  "<a class="link" href="GtkPrinter.html#GtkPrinter--location" title='The "location" property'>location</a>"                 <span class="type">gchar</span>*                : Read
 
110
  "<a class="link" href="GtkPrinter.html#GtkPrinter--name" title='The "name" property'>name</a>"                     <span class="type">gchar</span>*                : Read / Write / Construct Only
 
111
  "<a class="link" href="GtkPrinter.html#GtkPrinter--paused" title='The "paused" property'>paused</a>"                   <span class="type">gboolean</span>              : Read
 
112
  "<a class="link" href="GtkPrinter.html#GtkPrinter--state-message" title='The "state-message" property'>state-message</a>"            <span class="type">gchar</span>*                : Read
 
113
</pre>
 
114
</div>
 
115
<div class="refsect1">
 
116
<a name="GtkPrinter.signals"></a><h2>Signals</h2>
 
117
<pre class="synopsis">
 
118
  "<a class="link" href="GtkPrinter.html#GtkPrinter-details-acquired" title='The "details-acquired" signal'>details-acquired</a>"                               : <code class="literal">Run Last</code>
 
119
</pre>
 
120
</div>
 
121
<div class="refsect1">
 
122
<a name="GtkPrinter.description"></a><h2>Description</h2>
 
123
<p>
 
124
A <a class="link" href="GtkPrinter.html" title="GtkPrinter"><span class="type">GtkPrinter</span></a> object represents a printer. You only need to
 
125
deal directly with printers if you use the non-portable
 
126
<a class="link" href="GtkPrintUnixDialog.html" title="GtkPrintUnixDialog"><span class="type">GtkPrintUnixDialog</span></a> API.
 
127
</p>
 
128
<p>
 
129
A <a class="link" href="GtkPrinter.html" title="GtkPrinter"><span class="type">GtkPrinter</span></a> allows to get status information about the printer,
 
130
such as its description, its location, the number of queued jobs,
 
131
etc. Most importantly, a <a class="link" href="GtkPrinter.html" title="GtkPrinter"><span class="type">GtkPrinter</span></a> object can be used to create
 
132
a <a class="link" href="GtkPrintJob.html" title="GtkPrintJob"><span class="type">GtkPrintJob</span></a> object, which lets you print to the printer.
 
133
</p>
 
134
<p>
 
135
Printing support was added in GTK+ 2.10.
 
136
</p>
 
137
</div>
 
138
<div class="refsect1">
 
139
<a name="GtkPrinter.details"></a><h2>Details</h2>
 
140
<div class="refsect2">
 
141
<a name="GtkPrinter-struct"></a><h3>struct GtkPrinter</h3>
 
142
<pre class="programlisting">struct GtkPrinter;</pre>
 
143
<p>
 
144
</p>
 
145
</div>
 
146
<hr>
 
147
<div class="refsect2">
 
148
<a name="GtkPrintBackend-struct"></a><h3>GtkPrintBackend</h3>
 
149
<pre class="programlisting">typedef struct _GtkPrintBackend GtkPrintBackend;</pre>
 
150
<p>
 
151
</p>
 
152
</div>
 
153
<hr>
 
154
<div class="refsect2">
 
155
<a name="gtk-printer-new"></a><h3>gtk_printer_new ()</h3>
 
156
<pre class="programlisting"><a class="link" href="GtkPrinter.html" title="GtkPrinter"><span class="returnvalue">GtkPrinter</span></a> *        gtk_printer_new                     (<em class="parameter"><code>const <span class="type">gchar</span> *name</code></em>,
 
157
                                                         <em class="parameter"><code><a class="link" href="GtkPrinter.html#GtkPrintBackend"><span class="type">GtkPrintBackend</span></a> *backend</code></em>,
 
158
                                                         <em class="parameter"><code><span class="type">gboolean</span> virtual_</code></em>);</pre>
 
159
<p>
 
160
Creates a new <a class="link" href="GtkPrinter.html" title="GtkPrinter"><span class="type">GtkPrinter</span></a>.
 
161
</p>
 
162
<div class="variablelist"><table border="0" class="variablelist">
 
163
<colgroup>
 
164
<col align="left" valign="top">
 
165
<col>
 
166
</colgroup>
 
167
<tbody>
 
168
<tr>
 
169
<td><p><span class="term"><em class="parameter"><code>name</code></em> :</span></p></td>
 
170
<td>the name of the printer</td>
 
171
</tr>
 
172
<tr>
 
173
<td><p><span class="term"><em class="parameter"><code>backend</code></em> :</span></p></td>
 
174
<td>a <a class="link" href="GtkPrinter.html#GtkPrintBackend"><span class="type">GtkPrintBackend</span></a>
 
175
</td>
 
176
</tr>
 
177
<tr>
 
178
<td><p><span class="term"><em class="parameter"><code>virtual_</code></em> :</span></p></td>
 
179
<td>whether the printer is virtual</td>
 
180
</tr>
 
181
<tr>
 
182
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
 
183
<td>a new <a class="link" href="GtkPrinter.html" title="GtkPrinter"><span class="type">GtkPrinter</span></a>
 
184
</td>
 
185
</tr>
 
186
</tbody>
 
187
</table></div>
 
188
<p class="since">Since 2.10</p>
 
189
</div>
 
190
<hr>
 
191
<div class="refsect2">
 
192
<a name="gtk-printer-get-backend"></a><h3>gtk_printer_get_backend ()</h3>
 
193
<pre class="programlisting"><a class="link" href="GtkPrinter.html#GtkPrintBackend"><span class="returnvalue">GtkPrintBackend</span></a> *   gtk_printer_get_backend             (<em class="parameter"><code><a class="link" href="GtkPrinter.html" title="GtkPrinter"><span class="type">GtkPrinter</span></a> *printer</code></em>);</pre>
 
194
<p>
 
195
Returns the backend of the printer.
 
196
</p>
 
197
<div class="variablelist"><table border="0" class="variablelist">
 
198
<colgroup>
 
199
<col align="left" valign="top">
 
200
<col>
 
201
</colgroup>
 
202
<tbody>
 
203
<tr>
 
204
<td><p><span class="term"><em class="parameter"><code>printer</code></em> :</span></p></td>
 
205
<td>a <a class="link" href="GtkPrinter.html" title="GtkPrinter"><span class="type">GtkPrinter</span></a>
 
206
</td>
 
207
</tr>
 
208
<tr>
 
209
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
 
210
<td>the backend of <em class="parameter"><code>printer</code></em>. <span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span>
 
211
</td>
 
212
</tr>
 
213
</tbody>
 
214
</table></div>
 
215
<p class="since">Since 2.10</p>
 
216
</div>
 
217
<hr>
 
218
<div class="refsect2">
 
219
<a name="gtk-printer-get-name"></a><h3>gtk_printer_get_name ()</h3>
 
220
<pre class="programlisting">const <span class="returnvalue">gchar</span> *       gtk_printer_get_name                (<em class="parameter"><code><a class="link" href="GtkPrinter.html" title="GtkPrinter"><span class="type">GtkPrinter</span></a> *printer</code></em>);</pre>
 
221
<p>
 
222
Returns the name of the printer.
 
223
</p>
 
224
<div class="variablelist"><table border="0" class="variablelist">
 
225
<colgroup>
 
226
<col align="left" valign="top">
 
227
<col>
 
228
</colgroup>
 
229
<tbody>
 
230
<tr>
 
231
<td><p><span class="term"><em class="parameter"><code>printer</code></em> :</span></p></td>
 
232
<td>a <a class="link" href="GtkPrinter.html" title="GtkPrinter"><span class="type">GtkPrinter</span></a>
 
233
</td>
 
234
</tr>
 
235
<tr>
 
236
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
 
237
<td>the name of <em class="parameter"><code>printer</code></em>
 
238
</td>
 
239
</tr>
 
240
</tbody>
 
241
</table></div>
 
242
<p class="since">Since 2.10</p>
 
243
</div>
 
244
<hr>
 
245
<div class="refsect2">
 
246
<a name="gtk-printer-get-state-message"></a><h3>gtk_printer_get_state_message ()</h3>
 
247
<pre class="programlisting">const <span class="returnvalue">gchar</span> *       gtk_printer_get_state_message       (<em class="parameter"><code><a class="link" href="GtkPrinter.html" title="GtkPrinter"><span class="type">GtkPrinter</span></a> *printer</code></em>);</pre>
 
248
<p>
 
249
Returns the state message describing the current state
 
250
of the printer.
 
251
</p>
 
252
<div class="variablelist"><table border="0" class="variablelist">
 
253
<colgroup>
 
254
<col align="left" valign="top">
 
255
<col>
 
256
</colgroup>
 
257
<tbody>
 
258
<tr>
 
259
<td><p><span class="term"><em class="parameter"><code>printer</code></em> :</span></p></td>
 
260
<td>a <a class="link" href="GtkPrinter.html" title="GtkPrinter"><span class="type">GtkPrinter</span></a>
 
261
</td>
 
262
</tr>
 
263
<tr>
 
264
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
 
265
<td>the state message of <em class="parameter"><code>printer</code></em>
 
266
</td>
 
267
</tr>
 
268
</tbody>
 
269
</table></div>
 
270
<p class="since">Since 2.10</p>
 
271
</div>
 
272
<hr>
 
273
<div class="refsect2">
 
274
<a name="gtk-printer-get-description"></a><h3>gtk_printer_get_description ()</h3>
 
275
<pre class="programlisting">const <span class="returnvalue">gchar</span> *       gtk_printer_get_description         (<em class="parameter"><code><a class="link" href="GtkPrinter.html" title="GtkPrinter"><span class="type">GtkPrinter</span></a> *printer</code></em>);</pre>
 
276
<p>
 
277
Gets the description of the printer.
 
278
</p>
 
279
<div class="variablelist"><table border="0" class="variablelist">
 
280
<colgroup>
 
281
<col align="left" valign="top">
 
282
<col>
 
283
</colgroup>
 
284
<tbody>
 
285
<tr>
 
286
<td><p><span class="term"><em class="parameter"><code>printer</code></em> :</span></p></td>
 
287
<td>a <a class="link" href="GtkPrinter.html" title="GtkPrinter"><span class="type">GtkPrinter</span></a>
 
288
</td>
 
289
</tr>
 
290
<tr>
 
291
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
 
292
<td>the description of <em class="parameter"><code>printer</code></em>
 
293
</td>
 
294
</tr>
 
295
</tbody>
 
296
</table></div>
 
297
<p class="since">Since 2.10</p>
 
298
</div>
 
299
<hr>
 
300
<div class="refsect2">
 
301
<a name="gtk-printer-get-location"></a><h3>gtk_printer_get_location ()</h3>
 
302
<pre class="programlisting">const <span class="returnvalue">gchar</span> *       gtk_printer_get_location            (<em class="parameter"><code><a class="link" href="GtkPrinter.html" title="GtkPrinter"><span class="type">GtkPrinter</span></a> *printer</code></em>);</pre>
 
303
<p>
 
304
Returns a description of the location of the printer.
 
305
</p>
 
306
<div class="variablelist"><table border="0" class="variablelist">
 
307
<colgroup>
 
308
<col align="left" valign="top">
 
309
<col>
 
310
</colgroup>
 
311
<tbody>
 
312
<tr>
 
313
<td><p><span class="term"><em class="parameter"><code>printer</code></em> :</span></p></td>
 
314
<td>a <a class="link" href="GtkPrinter.html" title="GtkPrinter"><span class="type">GtkPrinter</span></a>
 
315
</td>
 
316
</tr>
 
317
<tr>
 
318
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
 
319
<td>the location of <em class="parameter"><code>printer</code></em>
 
320
</td>
 
321
</tr>
 
322
</tbody>
 
323
</table></div>
 
324
<p class="since">Since 2.10</p>
 
325
</div>
 
326
<hr>
 
327
<div class="refsect2">
 
328
<a name="gtk-printer-get-icon-name"></a><h3>gtk_printer_get_icon_name ()</h3>
 
329
<pre class="programlisting">const <span class="returnvalue">gchar</span> *       gtk_printer_get_icon_name           (<em class="parameter"><code><a class="link" href="GtkPrinter.html" title="GtkPrinter"><span class="type">GtkPrinter</span></a> *printer</code></em>);</pre>
 
330
<p>
 
331
Gets the name of the icon to use for the printer.
 
332
</p>
 
333
<div class="variablelist"><table border="0" class="variablelist">
 
334
<colgroup>
 
335
<col align="left" valign="top">
 
336
<col>
 
337
</colgroup>
 
338
<tbody>
 
339
<tr>
 
340
<td><p><span class="term"><em class="parameter"><code>printer</code></em> :</span></p></td>
 
341
<td>a <a class="link" href="GtkPrinter.html" title="GtkPrinter"><span class="type">GtkPrinter</span></a>
 
342
</td>
 
343
</tr>
 
344
<tr>
 
345
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
 
346
<td>the icon name for <em class="parameter"><code>printer</code></em>
 
347
</td>
 
348
</tr>
 
349
</tbody>
 
350
</table></div>
 
351
<p class="since">Since 2.10</p>
 
352
</div>
 
353
<hr>
 
354
<div class="refsect2">
 
355
<a name="gtk-printer-get-job-count"></a><h3>gtk_printer_get_job_count ()</h3>
 
356
<pre class="programlisting"><span class="returnvalue">gint</span>                gtk_printer_get_job_count           (<em class="parameter"><code><a class="link" href="GtkPrinter.html" title="GtkPrinter"><span class="type">GtkPrinter</span></a> *printer</code></em>);</pre>
 
357
<p>
 
358
Gets the number of jobs currently queued on the printer.
 
359
</p>
 
360
<div class="variablelist"><table border="0" class="variablelist">
 
361
<colgroup>
 
362
<col align="left" valign="top">
 
363
<col>
 
364
</colgroup>
 
365
<tbody>
 
366
<tr>
 
367
<td><p><span class="term"><em class="parameter"><code>printer</code></em> :</span></p></td>
 
368
<td>a <a class="link" href="GtkPrinter.html" title="GtkPrinter"><span class="type">GtkPrinter</span></a>
 
369
</td>
 
370
</tr>
 
371
<tr>
 
372
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
 
373
<td>the number of jobs on <em class="parameter"><code>printer</code></em>
 
374
</td>
 
375
</tr>
 
376
</tbody>
 
377
</table></div>
 
378
<p class="since">Since 2.10</p>
 
379
</div>
 
380
<hr>
 
381
<div class="refsect2">
 
382
<a name="gtk-printer-is-active"></a><h3>gtk_printer_is_active ()</h3>
 
383
<pre class="programlisting"><span class="returnvalue">gboolean</span>            gtk_printer_is_active               (<em class="parameter"><code><a class="link" href="GtkPrinter.html" title="GtkPrinter"><span class="type">GtkPrinter</span></a> *printer</code></em>);</pre>
 
384
<p>
 
385
Returns whether the printer is currently active (i.e. 
 
386
accepts new jobs).
 
387
</p>
 
388
<div class="variablelist"><table border="0" class="variablelist">
 
389
<colgroup>
 
390
<col align="left" valign="top">
 
391
<col>
 
392
</colgroup>
 
393
<tbody>
 
394
<tr>
 
395
<td><p><span class="term"><em class="parameter"><code>printer</code></em> :</span></p></td>
 
396
<td>a <a class="link" href="GtkPrinter.html" title="GtkPrinter"><span class="type">GtkPrinter</span></a>
 
397
</td>
 
398
</tr>
 
399
<tr>
 
400
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
 
401
<td>
 
402
<code class="literal">TRUE</code> if <em class="parameter"><code>printer</code></em> is active</td>
 
403
</tr>
 
404
</tbody>
 
405
</table></div>
 
406
<p class="since">Since 2.10</p>
 
407
</div>
 
408
<hr>
 
409
<div class="refsect2">
 
410
<a name="gtk-printer-is-paused"></a><h3>gtk_printer_is_paused ()</h3>
 
411
<pre class="programlisting"><span class="returnvalue">gboolean</span>            gtk_printer_is_paused               (<em class="parameter"><code><a class="link" href="GtkPrinter.html" title="GtkPrinter"><span class="type">GtkPrinter</span></a> *printer</code></em>);</pre>
 
412
<p>
 
413
Returns whether the printer is currently paused.
 
414
A paused printer still accepts jobs, but it is not
 
415
printing them.
 
416
</p>
 
417
<div class="variablelist"><table border="0" class="variablelist">
 
418
<colgroup>
 
419
<col align="left" valign="top">
 
420
<col>
 
421
</colgroup>
 
422
<tbody>
 
423
<tr>
 
424
<td><p><span class="term"><em class="parameter"><code>printer</code></em> :</span></p></td>
 
425
<td>a <a class="link" href="GtkPrinter.html" title="GtkPrinter"><span class="type">GtkPrinter</span></a>
 
426
</td>
 
427
</tr>
 
428
<tr>
 
429
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
 
430
<td>
 
431
<code class="literal">TRUE</code> if <em class="parameter"><code>printer</code></em> is paused</td>
 
432
</tr>
 
433
</tbody>
 
434
</table></div>
 
435
<p class="since">Since 2.14</p>
 
436
</div>
 
437
<hr>
 
438
<div class="refsect2">
 
439
<a name="gtk-printer-is-accepting-jobs"></a><h3>gtk_printer_is_accepting_jobs ()</h3>
 
440
<pre class="programlisting"><span class="returnvalue">gboolean</span>            gtk_printer_is_accepting_jobs       (<em class="parameter"><code><a class="link" href="GtkPrinter.html" title="GtkPrinter"><span class="type">GtkPrinter</span></a> *printer</code></em>);</pre>
 
441
<p>
 
442
Returns whether the printer is accepting jobs
 
443
</p>
 
444
<div class="variablelist"><table border="0" class="variablelist">
 
445
<colgroup>
 
446
<col align="left" valign="top">
 
447
<col>
 
448
</colgroup>
 
449
<tbody>
 
450
<tr>
 
451
<td><p><span class="term"><em class="parameter"><code>printer</code></em> :</span></p></td>
 
452
<td>a <a class="link" href="GtkPrinter.html" title="GtkPrinter"><span class="type">GtkPrinter</span></a>
 
453
</td>
 
454
</tr>
 
455
<tr>
 
456
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
 
457
<td>
 
458
<code class="literal">TRUE</code> if <em class="parameter"><code>printer</code></em> is accepting jobs</td>
 
459
</tr>
 
460
</tbody>
 
461
</table></div>
 
462
<p class="since">Since 2.14</p>
 
463
</div>
 
464
<hr>
 
465
<div class="refsect2">
 
466
<a name="gtk-printer-is-virtual"></a><h3>gtk_printer_is_virtual ()</h3>
 
467
<pre class="programlisting"><span class="returnvalue">gboolean</span>            gtk_printer_is_virtual              (<em class="parameter"><code><a class="link" href="GtkPrinter.html" title="GtkPrinter"><span class="type">GtkPrinter</span></a> *printer</code></em>);</pre>
 
468
<p>
 
469
Returns whether the printer is virtual (i.e. does not
 
470
represent actual printer hardware, but something like 
 
471
a CUPS class).
 
472
</p>
 
473
<div class="variablelist"><table border="0" class="variablelist">
 
474
<colgroup>
 
475
<col align="left" valign="top">
 
476
<col>
 
477
</colgroup>
 
478
<tbody>
 
479
<tr>
 
480
<td><p><span class="term"><em class="parameter"><code>printer</code></em> :</span></p></td>
 
481
<td>a <a class="link" href="GtkPrinter.html" title="GtkPrinter"><span class="type">GtkPrinter</span></a>
 
482
</td>
 
483
</tr>
 
484
<tr>
 
485
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
 
486
<td>
 
487
<code class="literal">TRUE</code> if <em class="parameter"><code>printer</code></em> is virtual</td>
 
488
</tr>
 
489
</tbody>
 
490
</table></div>
 
491
<p class="since">Since 2.10</p>
 
492
</div>
 
493
<hr>
 
494
<div class="refsect2">
 
495
<a name="gtk-printer-is-default"></a><h3>gtk_printer_is_default ()</h3>
 
496
<pre class="programlisting"><span class="returnvalue">gboolean</span>            gtk_printer_is_default              (<em class="parameter"><code><a class="link" href="GtkPrinter.html" title="GtkPrinter"><span class="type">GtkPrinter</span></a> *printer</code></em>);</pre>
 
497
<p>
 
498
Returns whether the printer is the default printer.
 
499
</p>
 
500
<div class="variablelist"><table border="0" class="variablelist">
 
501
<colgroup>
 
502
<col align="left" valign="top">
 
503
<col>
 
504
</colgroup>
 
505
<tbody>
 
506
<tr>
 
507
<td><p><span class="term"><em class="parameter"><code>printer</code></em> :</span></p></td>
 
508
<td>a <a class="link" href="GtkPrinter.html" title="GtkPrinter"><span class="type">GtkPrinter</span></a>
 
509
</td>
 
510
</tr>
 
511
<tr>
 
512
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
 
513
<td>
 
514
<code class="literal">TRUE</code> if <em class="parameter"><code>printer</code></em> is the default</td>
 
515
</tr>
 
516
</tbody>
 
517
</table></div>
 
518
<p class="since">Since 2.10</p>
 
519
</div>
 
520
<hr>
 
521
<div class="refsect2">
 
522
<a name="gtk-printer-accepts-ps"></a><h3>gtk_printer_accepts_ps ()</h3>
 
523
<pre class="programlisting"><span class="returnvalue">gboolean</span>            gtk_printer_accepts_ps              (<em class="parameter"><code><a class="link" href="GtkPrinter.html" title="GtkPrinter"><span class="type">GtkPrinter</span></a> *printer</code></em>);</pre>
 
524
<p>
 
525
Returns whether the printer accepts input in
 
526
PostScript format.
 
527
</p>
 
528
<div class="variablelist"><table border="0" class="variablelist">
 
529
<colgroup>
 
530
<col align="left" valign="top">
 
531
<col>
 
532
</colgroup>
 
533
<tbody>
 
534
<tr>
 
535
<td><p><span class="term"><em class="parameter"><code>printer</code></em> :</span></p></td>
 
536
<td>a <a class="link" href="GtkPrinter.html" title="GtkPrinter"><span class="type">GtkPrinter</span></a>
 
537
</td>
 
538
</tr>
 
539
<tr>
 
540
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
 
541
<td>
 
542
<code class="literal">TRUE</code> if <em class="parameter"><code>printer</code></em> accepts PostScript</td>
 
543
</tr>
 
544
</tbody>
 
545
</table></div>
 
546
<p class="since">Since 2.10</p>
 
547
</div>
 
548
<hr>
 
549
<div class="refsect2">
 
550
<a name="gtk-printer-accepts-pdf"></a><h3>gtk_printer_accepts_pdf ()</h3>
 
551
<pre class="programlisting"><span class="returnvalue">gboolean</span>            gtk_printer_accepts_pdf             (<em class="parameter"><code><a class="link" href="GtkPrinter.html" title="GtkPrinter"><span class="type">GtkPrinter</span></a> *printer</code></em>);</pre>
 
552
<p>
 
553
Returns whether the printer accepts input in
 
554
PDF format.
 
555
</p>
 
556
<div class="variablelist"><table border="0" class="variablelist">
 
557
<colgroup>
 
558
<col align="left" valign="top">
 
559
<col>
 
560
</colgroup>
 
561
<tbody>
 
562
<tr>
 
563
<td><p><span class="term"><em class="parameter"><code>printer</code></em> :</span></p></td>
 
564
<td>a <a class="link" href="GtkPrinter.html" title="GtkPrinter"><span class="type">GtkPrinter</span></a>
 
565
</td>
 
566
</tr>
 
567
<tr>
 
568
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
 
569
<td>
 
570
<code class="literal">TRUE</code> if <em class="parameter"><code>printer</code></em> accepts PDF</td>
 
571
</tr>
 
572
</tbody>
 
573
</table></div>
 
574
<p class="since">Since 2.10</p>
 
575
</div>
 
576
<hr>
 
577
<div class="refsect2">
 
578
<a name="gtk-printer-list-papers"></a><h3>gtk_printer_list_papers ()</h3>
 
579
<pre class="programlisting"><span class="returnvalue">GList</span> *             gtk_printer_list_papers             (<em class="parameter"><code><a class="link" href="GtkPrinter.html" title="GtkPrinter"><span class="type">GtkPrinter</span></a> *printer</code></em>);</pre>
 
580
<p>
 
581
Lists all the paper sizes <em class="parameter"><code>printer</code></em> supports.
 
582
This will return and empty list unless the printer's details are 
 
583
available, see <a class="link" href="GtkPrinter.html#gtk-printer-has-details" title="gtk_printer_has_details ()"><code class="function">gtk_printer_has_details()</code></a> and <a class="link" href="GtkPrinter.html#gtk-printer-request-details" title="gtk_printer_request_details ()"><code class="function">gtk_printer_request_details()</code></a>.
 
584
</p>
 
585
<div class="variablelist"><table border="0" class="variablelist">
 
586
<colgroup>
 
587
<col align="left" valign="top">
 
588
<col>
 
589
</colgroup>
 
590
<tbody>
 
591
<tr>
 
592
<td><p><span class="term"><em class="parameter"><code>printer</code></em> :</span></p></td>
 
593
<td>a <a class="link" href="GtkPrinter.html" title="GtkPrinter"><span class="type">GtkPrinter</span></a>
 
594
</td>
 
595
</tr>
 
596
<tr>
 
597
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
 
598
<td>a newly allocated list of newly allocated <a class="link" href="GtkPageSetup.html" title="GtkPageSetup"><span class="type">GtkPageSetup</span></a> s. <span class="annotation">[<acronym title="Generics and defining elements of containers and arrays."><span class="acronym">element-type</span></acronym> GtkPageSetup][<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span>
 
599
</td>
 
600
</tr>
 
601
</tbody>
 
602
</table></div>
 
603
<p class="since">Since 2.12</p>
 
604
</div>
 
605
<hr>
 
606
<div class="refsect2">
 
607
<a name="gtk-printer-compare"></a><h3>gtk_printer_compare ()</h3>
 
608
<pre class="programlisting"><span class="returnvalue">gint</span>                gtk_printer_compare                 (<em class="parameter"><code><a class="link" href="GtkPrinter.html" title="GtkPrinter"><span class="type">GtkPrinter</span></a> *a</code></em>,
 
609
                                                         <em class="parameter"><code><a class="link" href="GtkPrinter.html" title="GtkPrinter"><span class="type">GtkPrinter</span></a> *b</code></em>);</pre>
 
610
<p>
 
611
Compares two printers.
 
612
</p>
 
613
<div class="variablelist"><table border="0" class="variablelist">
 
614
<colgroup>
 
615
<col align="left" valign="top">
 
616
<col>
 
617
</colgroup>
 
618
<tbody>
 
619
<tr>
 
620
<td><p><span class="term"><em class="parameter"><code>a</code></em> :</span></p></td>
 
621
<td>a <a class="link" href="GtkPrinter.html" title="GtkPrinter"><span class="type">GtkPrinter</span></a>
 
622
</td>
 
623
</tr>
 
624
<tr>
 
625
<td><p><span class="term"><em class="parameter"><code>b</code></em> :</span></p></td>
 
626
<td>another <a class="link" href="GtkPrinter.html" title="GtkPrinter"><span class="type">GtkPrinter</span></a>
 
627
</td>
 
628
</tr>
 
629
<tr>
 
630
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
 
631
<td>0 if the printer match, a negative value if <em class="parameter"><code>a</code></em> &lt; <em class="parameter"><code>b</code></em>,
 
632
or a positive value if <em class="parameter"><code>a</code></em> &gt; <em class="parameter"><code>b</code></em>
 
633
</td>
 
634
</tr>
 
635
</tbody>
 
636
</table></div>
 
637
<p class="since">Since 2.10</p>
 
638
</div>
 
639
<hr>
 
640
<div class="refsect2">
 
641
<a name="gtk-printer-has-details"></a><h3>gtk_printer_has_details ()</h3>
 
642
<pre class="programlisting"><span class="returnvalue">gboolean</span>            gtk_printer_has_details             (<em class="parameter"><code><a class="link" href="GtkPrinter.html" title="GtkPrinter"><span class="type">GtkPrinter</span></a> *printer</code></em>);</pre>
 
643
<p>
 
644
Returns whether the printer details are available.
 
645
</p>
 
646
<div class="variablelist"><table border="0" class="variablelist">
 
647
<colgroup>
 
648
<col align="left" valign="top">
 
649
<col>
 
650
</colgroup>
 
651
<tbody>
 
652
<tr>
 
653
<td><p><span class="term"><em class="parameter"><code>printer</code></em> :</span></p></td>
 
654
<td>a <a class="link" href="GtkPrinter.html" title="GtkPrinter"><span class="type">GtkPrinter</span></a>
 
655
</td>
 
656
</tr>
 
657
<tr>
 
658
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
 
659
<td>
 
660
<code class="literal">TRUE</code> if <em class="parameter"><code>printer</code></em> details are available</td>
 
661
</tr>
 
662
</tbody>
 
663
</table></div>
 
664
<p class="since">Since 2.12</p>
 
665
</div>
 
666
<hr>
 
667
<div class="refsect2">
 
668
<a name="gtk-printer-request-details"></a><h3>gtk_printer_request_details ()</h3>
 
669
<pre class="programlisting"><span class="returnvalue">void</span>                gtk_printer_request_details         (<em class="parameter"><code><a class="link" href="GtkPrinter.html" title="GtkPrinter"><span class="type">GtkPrinter</span></a> *printer</code></em>);</pre>
 
670
<p>
 
671
Requests the printer details. When the details are available,
 
672
the <a class="link" href="GtkPrinter.html#GtkPrinter-details-acquired" title='The "details-acquired" signal'><span class="type">"details-acquired"</span></a> signal will be emitted on <em class="parameter"><code>printer</code></em>.
 
673
</p>
 
674
<div class="variablelist"><table border="0" class="variablelist">
 
675
<colgroup>
 
676
<col align="left" valign="top">
 
677
<col>
 
678
</colgroup>
 
679
<tbody><tr>
 
680
<td><p><span class="term"><em class="parameter"><code>printer</code></em> :</span></p></td>
 
681
<td>a <a class="link" href="GtkPrinter.html" title="GtkPrinter"><span class="type">GtkPrinter</span></a>
 
682
</td>
 
683
</tr></tbody>
 
684
</table></div>
 
685
<p class="since">Since 2.12</p>
 
686
</div>
 
687
<hr>
 
688
<div class="refsect2">
 
689
<a name="gtk-printer-get-capabilities"></a><h3>gtk_printer_get_capabilities ()</h3>
 
690
<pre class="programlisting"><a class="link" href="GtkPrintUnixDialog.html#GtkPrintCapabilities" title="enum GtkPrintCapabilities"><span class="returnvalue">GtkPrintCapabilities</span></a> gtk_printer_get_capabilities       (<em class="parameter"><code><a class="link" href="GtkPrinter.html" title="GtkPrinter"><span class="type">GtkPrinter</span></a> *printer</code></em>);</pre>
 
691
<p>
 
692
Returns the printer's capabilities.
 
693
</p>
 
694
<p>
 
695
This is useful when you're using <a class="link" href="GtkPrintUnixDialog.html" title="GtkPrintUnixDialog"><span class="type">GtkPrintUnixDialog</span></a>'s manual-capabilities 
 
696
setting and need to know which settings the printer can handle and which 
 
697
you must handle yourself.
 
698
</p>
 
699
<p>
 
700
This will return 0 unless the printer's details are available, see
 
701
<a class="link" href="GtkPrinter.html#gtk-printer-has-details" title="gtk_printer_has_details ()"><code class="function">gtk_printer_has_details()</code></a> and <a class="link" href="GtkPrinter.html#gtk-printer-request-details" title="gtk_printer_request_details ()"><code class="function">gtk_printer_request_details()</code></a>.
 
702
</p>
 
703
<div class="variablelist"><table border="0" class="variablelist">
 
704
<colgroup>
 
705
<col align="left" valign="top">
 
706
<col>
 
707
</colgroup>
 
708
<tbody>
 
709
<tr>
 
710
<td><p><span class="term"><em class="parameter"><code>printer</code></em> :</span></p></td>
 
711
<td>a <a class="link" href="GtkPrinter.html" title="GtkPrinter"><span class="type">GtkPrinter</span></a>
 
712
</td>
 
713
</tr>
 
714
<tr>
 
715
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
 
716
<td>the printer's capabilities</td>
 
717
</tr>
 
718
</tbody>
 
719
</table></div>
 
720
<p class="since">Since 2.12</p>
 
721
</div>
 
722
<hr>
 
723
<div class="refsect2">
 
724
<a name="gtk-printer-get-default-page-size"></a><h3>gtk_printer_get_default_page_size ()</h3>
 
725
<pre class="programlisting"><a class="link" href="GtkPageSetup.html" title="GtkPageSetup"><span class="returnvalue">GtkPageSetup</span></a> *      gtk_printer_get_default_page_size   (<em class="parameter"><code><a class="link" href="GtkPrinter.html" title="GtkPrinter"><span class="type">GtkPrinter</span></a> *printer</code></em>);</pre>
 
726
<p>
 
727
Returns default page size of <em class="parameter"><code>printer</code></em>.
 
728
</p>
 
729
<div class="variablelist"><table border="0" class="variablelist">
 
730
<colgroup>
 
731
<col align="left" valign="top">
 
732
<col>
 
733
</colgroup>
 
734
<tbody>
 
735
<tr>
 
736
<td><p><span class="term"><em class="parameter"><code>printer</code></em> :</span></p></td>
 
737
<td>a <a class="link" href="GtkPrinter.html" title="GtkPrinter"><span class="type">GtkPrinter</span></a>
 
738
</td>
 
739
</tr>
 
740
<tr>
 
741
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
 
742
<td>a newly allocated <a class="link" href="GtkPageSetup.html" title="GtkPageSetup"><span class="type">GtkPageSetup</span></a> with default page size of the printer.</td>
 
743
</tr>
 
744
</tbody>
 
745
</table></div>
 
746
<p class="since">Since 2.14</p>
 
747
</div>
 
748
<hr>
 
749
<div class="refsect2">
 
750
<a name="gtk-printer-get-hard-margins"></a><h3>gtk_printer_get_hard_margins ()</h3>
 
751
<pre class="programlisting"><span class="returnvalue">gboolean</span>            gtk_printer_get_hard_margins        (<em class="parameter"><code><a class="link" href="GtkPrinter.html" title="GtkPrinter"><span class="type">GtkPrinter</span></a> *printer</code></em>,
 
752
                                                         <em class="parameter"><code><span class="type">gdouble</span> *top</code></em>,
 
753
                                                         <em class="parameter"><code><span class="type">gdouble</span> *bottom</code></em>,
 
754
                                                         <em class="parameter"><code><span class="type">gdouble</span> *left</code></em>,
 
755
                                                         <em class="parameter"><code><span class="type">gdouble</span> *right</code></em>);</pre>
 
756
<p>
 
757
Retrieve the hard margins of <em class="parameter"><code>printer</code></em>, i.e. the margins that define
 
758
the area at the borders of the paper that the printer cannot print to.
 
759
</p>
 
760
<p>
 
761
Note: This will not succeed unless the printer's details are available,
 
762
see <a class="link" href="GtkPrinter.html#gtk-printer-has-details" title="gtk_printer_has_details ()"><code class="function">gtk_printer_has_details()</code></a> and <a class="link" href="GtkPrinter.html#gtk-printer-request-details" title="gtk_printer_request_details ()"><code class="function">gtk_printer_request_details()</code></a>.
 
763
</p>
 
764
<div class="variablelist"><table border="0" class="variablelist">
 
765
<colgroup>
 
766
<col align="left" valign="top">
 
767
<col>
 
768
</colgroup>
 
769
<tbody>
 
770
<tr>
 
771
<td><p><span class="term"><em class="parameter"><code>printer</code></em> :</span></p></td>
 
772
<td>a <a class="link" href="GtkPrinter.html" title="GtkPrinter"><span class="type">GtkPrinter</span></a>
 
773
</td>
 
774
</tr>
 
775
<tr>
 
776
<td><p><span class="term"><em class="parameter"><code>top</code></em> :</span></p></td>
 
777
<td>a location to store the top margin in. <span class="annotation">[<acronym title="Parameter for returning results. Default is transfer full."><span class="acronym">out</span></acronym>]</span>
 
778
</td>
 
779
</tr>
 
780
<tr>
 
781
<td><p><span class="term"><em class="parameter"><code>bottom</code></em> :</span></p></td>
 
782
<td>a location to store the bottom margin in. <span class="annotation">[<acronym title="Parameter for returning results. Default is transfer full."><span class="acronym">out</span></acronym>]</span>
 
783
</td>
 
784
</tr>
 
785
<tr>
 
786
<td><p><span class="term"><em class="parameter"><code>left</code></em> :</span></p></td>
 
787
<td>a location to store the left margin in. <span class="annotation">[<acronym title="Parameter for returning results. Default is transfer full."><span class="acronym">out</span></acronym>]</span>
 
788
</td>
 
789
</tr>
 
790
<tr>
 
791
<td><p><span class="term"><em class="parameter"><code>right</code></em> :</span></p></td>
 
792
<td>a location to store the right margin in. <span class="annotation">[<acronym title="Parameter for returning results. Default is transfer full."><span class="acronym">out</span></acronym>]</span>
 
793
</td>
 
794
</tr>
 
795
<tr>
 
796
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
 
797
<td>
 
798
<code class="literal">TRUE</code> iff the hard margins were retrieved</td>
 
799
</tr>
 
800
</tbody>
 
801
</table></div>
 
802
<p class="since">Since 2.20</p>
 
803
</div>
 
804
<hr>
 
805
<div class="refsect2">
 
806
<a name="GtkPrinterFunc"></a><h3>GtkPrinterFunc ()</h3>
 
807
<pre class="programlisting"><span class="returnvalue">gboolean</span>            (*GtkPrinterFunc)                   (<em class="parameter"><code><a class="link" href="GtkPrinter.html" title="GtkPrinter"><span class="type">GtkPrinter</span></a> *printer</code></em>,
 
808
                                                         <em class="parameter"><code><span class="type">gpointer</span> data</code></em>);</pre>
 
809
<p>
 
810
The type of function passed to <a class="link" href="GtkPrinter.html#gtk-enumerate-printers" title="gtk_enumerate_printers ()"><code class="function">gtk_enumerate_printers()</code></a>.
 
811
Note that you need to ref <em class="parameter"><code>printer</code></em>, if you want to keep
 
812
a reference to it after the function has returned.
 
813
</p>
 
814
<div class="variablelist"><table border="0" class="variablelist">
 
815
<colgroup>
 
816
<col align="left" valign="top">
 
817
<col>
 
818
</colgroup>
 
819
<tbody>
 
820
<tr>
 
821
<td><p><span class="term"><em class="parameter"><code>printer</code></em> :</span></p></td>
 
822
<td>a <a class="link" href="GtkPrinter.html" title="GtkPrinter"><span class="type">GtkPrinter</span></a>
 
823
</td>
 
824
</tr>
 
825
<tr>
 
826
<td><p><span class="term"><em class="parameter"><code>data</code></em> :</span></p></td>
 
827
<td>user data passed to <a class="link" href="GtkPrinter.html#gtk-enumerate-printers" title="gtk_enumerate_printers ()"><code class="function">gtk_enumerate_printers()</code></a>
 
828
</td>
 
829
</tr>
 
830
<tr>
 
831
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
 
832
<td>
 
833
<code class="literal">TRUE</code> to stop the enumeration, <code class="literal">FALSE</code> to continue</td>
 
834
</tr>
 
835
</tbody>
 
836
</table></div>
 
837
</div>
 
838
<hr>
 
839
<div class="refsect2">
 
840
<a name="gtk-enumerate-printers"></a><h3>gtk_enumerate_printers ()</h3>
 
841
<pre class="programlisting"><span class="returnvalue">void</span>                gtk_enumerate_printers              (<em class="parameter"><code><a class="link" href="GtkPrinter.html#GtkPrinterFunc" title="GtkPrinterFunc ()"><span class="type">GtkPrinterFunc</span></a> func</code></em>,
 
842
                                                         <em class="parameter"><code><span class="type">gpointer</span> data</code></em>,
 
843
                                                         <em class="parameter"><code><span class="type">GDestroyNotify</span> destroy</code></em>,
 
844
                                                         <em class="parameter"><code><span class="type">gboolean</span> wait</code></em>);</pre>
 
845
<p>
 
846
Calls a function for all <a class="link" href="GtkPrinter.html" title="GtkPrinter"><span class="type">GtkPrinter</span></a>s. 
 
847
If <em class="parameter"><code>func</code></em> returns <code class="literal">TRUE</code>, the enumeration is stopped.
 
848
</p>
 
849
<div class="variablelist"><table border="0" class="variablelist">
 
850
<colgroup>
 
851
<col align="left" valign="top">
 
852
<col>
 
853
</colgroup>
 
854
<tbody>
 
855
<tr>
 
856
<td><p><span class="term"><em class="parameter"><code>func</code></em> :</span></p></td>
 
857
<td>a function to call for each printer</td>
 
858
</tr>
 
859
<tr>
 
860
<td><p><span class="term"><em class="parameter"><code>data</code></em> :</span></p></td>
 
861
<td>user data to pass to <em class="parameter"><code>func</code></em>
 
862
</td>
 
863
</tr>
 
864
<tr>
 
865
<td><p><span class="term"><em class="parameter"><code>destroy</code></em> :</span></p></td>
 
866
<td>function to call if <em class="parameter"><code>data</code></em> is no longer needed</td>
 
867
</tr>
 
868
<tr>
 
869
<td><p><span class="term"><em class="parameter"><code>wait</code></em> :</span></p></td>
 
870
<td>if <code class="literal">TRUE</code>, wait in a recursive mainloop until
 
871
all printers are enumerated; otherwise return early</td>
 
872
</tr>
 
873
</tbody>
 
874
</table></div>
 
875
<p class="since">Since 2.10</p>
 
876
</div>
 
877
</div>
 
878
<div class="refsect1">
 
879
<a name="GtkPrinter.property-details"></a><h2>Property Details</h2>
 
880
<div class="refsect2">
 
881
<a name="GtkPrinter--accepting-jobs"></a><h3>The <code class="literal">"accepting-jobs"</code> property</h3>
 
882
<pre class="programlisting">  "accepting-jobs"           <span class="type">gboolean</span>              : Read</pre>
 
883
<p>
 
884
This property is <code class="literal">TRUE</code> if the printer is accepting jobs.
 
885
</p>
 
886
<p>Default value: TRUE</p>
 
887
<p class="since">Since 2.14</p>
 
888
</div>
 
889
<hr>
 
890
<div class="refsect2">
 
891
<a name="GtkPrinter--accepts-pdf"></a><h3>The <code class="literal">"accepts-pdf"</code> property</h3>
 
892
<pre class="programlisting">  "accepts-pdf"              <span class="type">gboolean</span>              : Read / Write / Construct Only</pre>
 
893
<p>TRUE if this printer can accept PDF.</p>
 
894
<p>Default value: FALSE</p>
 
895
</div>
 
896
<hr>
 
897
<div class="refsect2">
 
898
<a name="GtkPrinter--accepts-ps"></a><h3>The <code class="literal">"accepts-ps"</code> property</h3>
 
899
<pre class="programlisting">  "accepts-ps"               <span class="type">gboolean</span>              : Read / Write / Construct Only</pre>
 
900
<p>TRUE if this printer can accept PostScript.</p>
 
901
<p>Default value: TRUE</p>
 
902
</div>
 
903
<hr>
 
904
<div class="refsect2">
 
905
<a name="GtkPrinter--backend"></a><h3>The <code class="literal">"backend"</code> property</h3>
 
906
<pre class="programlisting">  "backend"                  <a class="link" href="GtkPrinter.html#GtkPrintBackend"><span class="type">GtkPrintBackend</span></a>*      : Read / Write / Construct Only</pre>
 
907
<p>Backend for the printer.</p>
 
908
</div>
 
909
<hr>
 
910
<div class="refsect2">
 
911
<a name="GtkPrinter--icon-name"></a><h3>The <code class="literal">"icon-name"</code> property</h3>
 
912
<pre class="programlisting">  "icon-name"                <span class="type">gchar</span>*                : Read</pre>
 
913
<p>The icon name to use for the printer.</p>
 
914
<p>Default value: ""</p>
 
915
</div>
 
916
<hr>
 
917
<div class="refsect2">
 
918
<a name="GtkPrinter--is-virtual"></a><h3>The <code class="literal">"is-virtual"</code> property</h3>
 
919
<pre class="programlisting">  "is-virtual"               <span class="type">gboolean</span>              : Read / Write / Construct Only</pre>
 
920
<p>FALSE if this represents a real hardware printer.</p>
 
921
<p>Default value: FALSE</p>
 
922
</div>
 
923
<hr>
 
924
<div class="refsect2">
 
925
<a name="GtkPrinter--job-count"></a><h3>The <code class="literal">"job-count"</code> property</h3>
 
926
<pre class="programlisting">  "job-count"                <span class="type">gint</span>                  : Read</pre>
 
927
<p>Number of jobs queued in the printer.</p>
 
928
<p>Allowed values: &gt;= 0</p>
 
929
<p>Default value: 0</p>
 
930
</div>
 
931
<hr>
 
932
<div class="refsect2">
 
933
<a name="GtkPrinter--location"></a><h3>The <code class="literal">"location"</code> property</h3>
 
934
<pre class="programlisting">  "location"                 <span class="type">gchar</span>*                : Read</pre>
 
935
<p>The location of the printer.</p>
 
936
<p>Default value: ""</p>
 
937
</div>
 
938
<hr>
 
939
<div class="refsect2">
 
940
<a name="GtkPrinter--name"></a><h3>The <code class="literal">"name"</code> property</h3>
 
941
<pre class="programlisting">  "name"                     <span class="type">gchar</span>*                : Read / Write / Construct Only</pre>
 
942
<p>Name of the printer.</p>
 
943
<p>Default value: ""</p>
 
944
</div>
 
945
<hr>
 
946
<div class="refsect2">
 
947
<a name="GtkPrinter--paused"></a><h3>The <code class="literal">"paused"</code> property</h3>
 
948
<pre class="programlisting">  "paused"                   <span class="type">gboolean</span>              : Read</pre>
 
949
<p>
 
950
This property is <code class="literal">TRUE</code> if this printer is paused.
 
951
A paused printer still accepts jobs, but it does 
 
952
not print them.
 
953
</p>
 
954
<p>Default value: FALSE</p>
 
955
<p class="since">Since 2.14</p>
 
956
</div>
 
957
<hr>
 
958
<div class="refsect2">
 
959
<a name="GtkPrinter--state-message"></a><h3>The <code class="literal">"state-message"</code> property</h3>
 
960
<pre class="programlisting">  "state-message"            <span class="type">gchar</span>*                : Read</pre>
 
961
<p>String giving the current state of the printer.</p>
 
962
<p>Default value: ""</p>
 
963
</div>
 
964
</div>
 
965
<div class="refsect1">
 
966
<a name="GtkPrinter.signal-details"></a><h2>Signal Details</h2>
 
967
<div class="refsect2">
 
968
<a name="GtkPrinter-details-acquired"></a><h3>The <code class="literal">"details-acquired"</code> signal</h3>
 
969
<pre class="programlisting"><span class="returnvalue">void</span>                user_function                      (<a class="link" href="GtkPrinter.html" title="GtkPrinter"><span class="type">GtkPrinter</span></a> *printer,
 
970
                                                        <span class="type">gboolean</span>    success,
 
971
                                                        <span class="type">gpointer</span>    user_data)      : <code class="literal">Run Last</code></pre>
 
972
<p>
 
973
Gets emitted in response to a request for detailed information
 
974
about a printer from the print backend. The <em class="parameter"><code>success</code></em> parameter
 
975
indicates if the information was actually obtained.
 
976
</p>
 
977
<div class="variablelist"><table border="0" class="variablelist">
 
978
<colgroup>
 
979
<col align="left" valign="top">
 
980
<col>
 
981
</colgroup>
 
982
<tbody>
 
983
<tr>
 
984
<td><p><span class="term"><em class="parameter"><code>printer</code></em> :</span></p></td>
 
985
<td>the <a class="link" href="GtkPrinter.html" title="GtkPrinter"><span class="type">GtkPrinter</span></a> on which the signal is emitted</td>
 
986
</tr>
 
987
<tr>
 
988
<td><p><span class="term"><em class="parameter"><code>success</code></em> :</span></p></td>
 
989
<td>
 
990
<code class="literal">TRUE</code> if the details were successfully acquired</td>
 
991
</tr>
 
992
<tr>
 
993
<td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td>
 
994
<td>user data set when the signal handler was connected.</td>
 
995
</tr>
 
996
</tbody>
 
997
</table></div>
 
998
<p class="since">Since 2.10</p>
 
999
</div>
 
1000
</div>
 
1001
</div>
 
1002
<div class="footer">
 
1003
<hr>
 
1004
          Generated by GTK-Doc V1.18</div>
 
1005
</body>
 
1006
</html>
 
 
b'\\ No newline at end of file'