gtkprinter.html

最新gtk中文资料集

<a class="indexterm" name="id4189718"></a><pre class="programlisting"><a class="link" href="GtkPrintUnixDialog.html#GtkPrintCapabilities">GtkPrintCapabilities</a> gtk_printer_get_capabilities       (<a class="link" href="GtkPrinter.html" title="GtkPrinter">GtkPrinter</a> *printer);</pre>
<p>
Returns the printer's capabilities.
</p>
<p>
This is useful when you're using <a class="link" href="GtkPrintUnixDialog.html" title="GtkPrintUnixDialog"><span class="type">GtkPrintUnixDialog</span></a>'s manual-capabilities 
setting and need to know which settings the printer can handle and which 
you must handle yourself.
</p>
<p>
This will return 0 unless the printer's details are available, see
<a class="link" href="GtkPrinter.html#gtk-printer-has-details"><code class="function">gtk_printer_has_details()</code></a> and <a class="link" href="GtkPrinter.html#gtk-printer-request-details"><code class="function">gtk_printer_request_details()</code></a>.
 *</p>
<p>

</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>printer</code></em>&#160;:</span></p></td>
<td> a <a class="link" href="GtkPrinter.html" title="GtkPrinter"><span class="type">GtkPrinter</span></a>
</td>
</tr>
<tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></p></td>
<td> the printer's capabilities

</td>
</tr>
</tbody>
</table></div>
<p class="since">Since  2.12
</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id4189836"></a><h3>
<a name="GtkPrinterFunc"></a>GtkPrinterFunc ()</h3>
<a class="indexterm" name="id4189849"></a><pre class="programlisting"><a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"
>gboolean</a>            (*GtkPrinterFunc)                   (<a class="link" href="GtkPrinter.html" title="GtkPrinter">GtkPrinter</a> *printer,
                                                         <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"
>gpointer</a> data);</pre>
<p>
The type of function passed to <a class="link" href="GtkPrinter.html#gtk-enumerate-printers"><code class="function">gtk_enumerate_printers()</code></a>.
Note that you need to ref <em class="parameter"><code>printer</code></em>, if you want to keep
a reference to it after the function has returned.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>printer</code></em>&#160;:</span></p></td>
<td>a <a class="link" href="GtkPrinter.html" title="GtkPrinter"><span class="type">GtkPrinter</span></a>
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>data</code></em>&#160;:</span></p></td>
<td>user data passed to <a class="link" href="GtkPrinter.html#gtk-enumerate-printers"><code class="function">gtk_enumerate_printers()</code></a>
</td>
</tr>
<tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></p></td>
<td>
<a
href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#TRUE:CAPS"
><code class="literal">TRUE</code></a> to stop the enumeration, <a
href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#FALSE:CAPS"
><code class="literal">FALSE</code></a> to continue


</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id4189984"></a><h3>
<a name="gtk-enumerate-printers"></a>gtk_enumerate_printers ()</h3>
<a class="indexterm" name="id4190000"></a><pre class="programlisting">void                gtk_enumerate_printers              (<a class="link" href="GtkPrinter.html#GtkPrinterFunc">GtkPrinterFunc</a> func,
                                                         <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"
>gpointer</a> data,
                                                         <a
href="/usr/share/gtk-doc/html/glib/glib-Datasets.html#GDestroyNotify"
>GDestroyNotify</a> destroy,
                                                         <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"
>gboolean</a> wait);</pre>
<p>
Calls a function for all <a class="link" href="GtkPrinter.html" title="GtkPrinter"><span class="type">GtkPrinter</span></a>s. 
If <em class="parameter"><code>func</code></em> returns <a
href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#TRUE:CAPS"
><code class="literal">TRUE</code></a>, the enumeration is stopped.</p>
<p>

</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>func</code></em>&#160;:</span></p></td>
<td> a function to call for each printer
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>data</code></em>&#160;:</span></p></td>
<td> user data to pass to <em class="parameter"><code>func</code></em>
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>destroy</code></em>&#160;:</span></p></td>
<td> function to call if <em class="parameter"><code>data</code></em> is no longer needed
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>wait</code></em>&#160;:</span></p></td>
<td> if <a
href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#TRUE:CAPS"
><code class="literal">TRUE</code></a>, wait in a recursive mainloop until
   all printers are enumerated; otherwise return early
</td>
</tr>
</tbody>
</table></div>
<p class="since">Since  2.10
</p>
</div>
</div>
<div class="refsect1" lang="en">
<a name="id4190175"></a><h2>Property Details</h2>
<div class="refsect2" lang="en">
<a name="id4190186"></a><h3>
<a name="GtkPrinter--accepts-pdf"></a>The <code class="literal">"accepts-pdf"</code> property</h3>
<a class="indexterm" name="id4190202"></a><pre class="programlisting">  "accepts-pdf"              <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"
>gboolean</a>              : Read / Write / Construct Only</pre>
<p>TRUE if this printer can accept PDF.</p>
<p>Default value: TRUE</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id4190229"></a><h3>
<a name="GtkPrinter--accepts-ps"></a>The <code class="literal">"accepts-ps"</code> property</h3>
<a class="indexterm" name="id4190246"></a><pre class="programlisting">  "accepts-ps"               <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"
>gboolean</a>              : Read / Write / Construct Only</pre>
<p>TRUE if this printer can accept PostScript.</p>
<p>Default value: TRUE</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id4190273"></a><h3>
<a name="GtkPrinter--backend"></a>The <code class="literal">"backend"</code> property</h3>
<a class="indexterm" name="id4190289"></a><pre class="programlisting">  "backend"                  <a class="link" href="GtkPrinter.html#GtkPrintBackend">GtkPrintBackend</a>       : Read / Write / Construct Only</pre>
<p>Backend for the printer.</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id4190312"></a><h3>
<a name="GtkPrinter--icon-name"></a>The <code class="literal">"icon-name"</code> property</h3>
<a class="indexterm" name="id4190328"></a><pre class="programlisting">  "icon-name"                <a
href="/usr/share/gtk-doc/html/gobject/gobject-Standard-Parameter-and-Value-Types.html#gchararray"
>gchararray</a>            : Read</pre>
<p>The icon name to use for the printer.</p>
<p>Default value: NULL</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id4190355"></a><h3>
<a name="GtkPrinter--is-virtual"></a>The <code class="literal">"is-virtual"</code> property</h3>
<a class="indexterm" name="id4190371"></a><pre class="programlisting">  "is-virtual"               <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"
>gboolean</a>              : Read / Write / Construct Only</pre>
<p>FALSE if this represents a real hardware printer.</p>
<p>Default value: FALSE</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id4190399"></a><h3>
<a name="GtkPrinter--job-count"></a>The <code class="literal">"job-count"</code> property</h3>
<a class="indexterm" name="id4190415"></a><pre class="programlisting">  "job-count"                <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"
>gint</a>                  : Read</pre>
<p>Number of jobs queued in the printer.</p>
<p>Allowed values: &gt;= 0</p>
<p>Default value: 0</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id4190446"></a><h3>
<a name="GtkPrinter--location"></a>The <code class="literal">"location"</code> property</h3>
<a class="indexterm" name="id4190462"></a><pre class="programlisting">  "location"                 <a
href="/usr/share/gtk-doc/html/gobject/gobject-Standard-Parameter-and-Value-Types.html#gchararray"
>gchararray</a>            : Read</pre>
<p>The location of the printer.</p>
<p>Default value: NULL</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id4190489"></a><h3>
<a name="GtkPrinter--name"></a>The <code class="literal">"name"</code> property</h3>
<a class="indexterm" name="id4190504"></a><pre class="programlisting">  "name"                     <a
href="/usr/share/gtk-doc/html/gobject/gobject-Standard-Parameter-and-Value-Types.html#gchararray"
>gchararray</a>            : Read / Write / Construct Only</pre>
<p>Name of the printer.</p>
<p>Default value: NULL</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id4190531"></a><h3>
<a name="GtkPrinter--state-message"></a>The <code class="literal">"state-message"</code> property</h3>
<a class="indexterm" name="id4190548"></a><pre class="programlisting">  "state-message"            <a
href="/usr/share/gtk-doc/html/gobject/gobject-Standard-Parameter-and-Value-Types.html#gchararray"
>gchararray</a>            : Read</pre>
<p>String giving the current state of the printer.</p>
<p>Default value: NULL</p>
</div>
</div>
<div class="refsect1" lang="en">
<a name="id4190576"></a><h2>Signal Details</h2>
<div class="refsect2" lang="en">
<a name="id4190586"></a><h3>
<a name="GtkPrinter-details-acquired"></a>The <code class="literal">"details-acquired"</code> signal</h3>
<a class="indexterm" name="id4190603"></a><pre class="programlisting">void                user_function                      (<a class="link" href="GtkPrinter.html" title="GtkPrinter">GtkPrinter</a> *printer,
                                                        <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"
>gboolean</a>    success,
                                                        <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"
>gpointer</a>    user_data)      : Run Last</pre>
<p>
Gets emitted in response to a request for detailed information
about a printer from the print backend. The <em class="parameter"><code>success</code></em> parameter
indicates if the information was actually obtained.</p>
<p>

</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>printer</code></em>&#160;:</span></p></td>
<td> the <a class="link" href="GtkPrinter.html" title="GtkPrinter"><span class="type">GtkPrinter</span></a> on which the signal is emitted
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>success</code></em>&#160;:</span></p></td>
<td> <a
href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#TRUE:CAPS"
><code class="literal">TRUE</code></a> if the details were successfully acquired
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>user_data</code></em>&#160;:</span></p></td>
<td>user data set when the signal handler was connected.</td>
</tr>
</tbody>
</table></div>
<p>Since  2.10
</p>
</div>
</div>
<div class="refsect1" lang="en">
<a name="id4190731"></a><div class="refsect2" lang="en"><a name="id4190732"></a></div>
<hr>
<div class="refsect2" lang="en"><a name="id4190733"></a></div>
</div>
</div>
</body>
</html>