gtk-high-level-printing-api.html

最新gtk中文资料集

</td>
</tr>
<tr>
<td><p><span class="term"><a name="GTK-PRINT-OPERATION-ACTION-PRINT:CAPS"></a><code class="literal">GTK_PRINT_OPERATION_ACTION_PRINT</code></span></p></td>
<td>Start to print without showing
   the print dialog, based on the current print settings.
</td>
</tr>
<tr>
<td><p><span class="term"><a name="GTK-PRINT-OPERATION-ACTION-PREVIEW:CAPS"></a><code class="literal">GTK_PRINT_OPERATION_ACTION_PREVIEW</code></span></p></td>
<td>Show the print preview.
</td>
</tr>
<tr>
<td><p><span class="term"><a name="GTK-PRINT-OPERATION-ACTION-EXPORT:CAPS"></a><code class="literal">GTK_PRINT_OPERATION_ACTION_EXPORT</code></span></p></td>
<td>Export to a file. This requires
  the export-filename property to be set.

</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id4129810"></a><h3>
<a name="GtkPrintOperationResult"></a>enum GtkPrintOperationResult</h3>
<a class="indexterm" name="id4129824"></a><pre class="programlisting">typedef enum {
  GTK_PRINT_OPERATION_RESULT_ERROR,
  GTK_PRINT_OPERATION_RESULT_APPLY,
  GTK_PRINT_OPERATION_RESULT_CANCEL,
  GTK_PRINT_OPERATION_RESULT_IN_PROGRESS
} GtkPrintOperationResult;
</pre>
<p>
A value of this type is returned by <a class="link" href="gtk-High-level-Printing-API.html#gtk-print-operation-run"><code class="function">gtk_print_operation_run()</code></a>.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><a name="GTK-PRINT-OPERATION-RESULT-ERROR:CAPS"></a><code class="literal">GTK_PRINT_OPERATION_RESULT_ERROR</code></span></p></td>
<td>An error has occured.
</td>
</tr>
<tr>
<td><p><span class="term"><a name="GTK-PRINT-OPERATION-RESULT-APPLY:CAPS"></a><code class="literal">GTK_PRINT_OPERATION_RESULT_APPLY</code></span></p></td>
<td>The print settings should be stored.
</td>
</tr>
<tr>
<td><p><span class="term"><a name="GTK-PRINT-OPERATION-RESULT-CANCEL:CAPS"></a><code class="literal">GTK_PRINT_OPERATION_RESULT_CANCEL</code></span></p></td>
<td>The print operation has been canceled,
  the print settings should not be stored.
</td>
</tr>
<tr>
<td><p><span class="term"><a name="GTK-PRINT-OPERATION-RESULT-IN-PROGRESS:CAPS"></a><code class="literal">GTK_PRINT_OPERATION_RESULT_IN_PROGRESS</code></span></p></td>
<td>The print operation is complete
  yet. This value will only be returned when running asynchronously.

</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id4129954"></a><h3>
<a name="GtkPrintError"></a>enum GtkPrintError</h3>
<a class="indexterm" name="id4129967"></a><pre class="programlisting">typedef enum
{
  GTK_PRINT_ERROR_GENERAL,
  GTK_PRINT_ERROR_INTERNAL_ERROR,
  GTK_PRINT_ERROR_NOMEM,
  GTK_PRINT_ERROR_INVALID_FILE
} GtkPrintError;
</pre>
<p>

</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id4129985"></a><h3>
<a name="GTK-PRINT-ERROR:CAPS"></a>GTK_PRINT_ERROR</h3>
<a class="indexterm" name="id4129998"></a><pre class="programlisting">#define GTK_PRINT_ERROR gtk_print_error_quark ()
</pre>
<p>
The <a
href="/usr/share/gtk-doc/html/glib/glib-Quarks.html#GQuark"
><span class="type">GQuark</span></a> used for <a class="link" href="gtk-High-level-Printing-API.html#GtkPrintError"><span class="type">GtkPrintError</span></a> errors.
</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id4130031"></a><h3>
<a name="gtk-print-operation-new"></a>gtk_print_operation_new ()</h3>
<a class="indexterm" name="id4130046"></a><pre class="programlisting"><a class="link" href="gtk-High-level-Printing-API.html#GtkPrintOperation">GtkPrintOperation</a>*  gtk_print_operation_new             (void);</pre>
<p>
Creates a new <a class="link" href="gtk-High-level-Printing-API.html#GtkPrintOperation"><span class="type">GtkPrintOperation</span></a>.</p>
<p>

</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody><tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></p></td>
<td> a new <a class="link" href="gtk-High-level-Printing-API.html#GtkPrintOperation"><span class="type">GtkPrintOperation</span></a>

</td>
</tr></tbody>
</table></div>
<p class="since">Since  2.10
</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id4130109"></a><h3>
<a name="gtk-print-operation-set-allow-async"></a>gtk_print_operation_set_allow_async ()</h3>
<a class="indexterm" name="id4130126"></a><pre class="programlisting">void                gtk_print_operation_set_allow_async (<a class="link" href="gtk-High-level-Printing-API.html#GtkPrintOperation">GtkPrintOperation</a> *op,
                                                         <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"
>gboolean</a> allow_async);</pre>
<p>
Sets whether the <a class="link" href="gtk-High-level-Printing-API.html#gtk-print-operation-run"><code class="function">gtk_print_operation_run()</code></a> may return
before the print operation is completed. Note that
some platforms may not allow asynchronous operation.</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>op</code></em>&#160;:</span></p></td>
<td> a <a class="link" href="gtk-High-level-Printing-API.html#GtkPrintOperation"><span class="type">GtkPrintOperation</span></a>
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>allow_async</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> to allow asynchronous operation
</td>
</tr>
</tbody>
</table></div>
<p class="since">Since  2.10
</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id4130236"></a><h3>
<a name="gtk-print-operation-get-error"></a>gtk_print_operation_get_error ()</h3>
<a class="indexterm" name="id4130252"></a><pre class="programlisting">void                gtk_print_operation_get_error       (<a class="link" href="gtk-High-level-Printing-API.html#GtkPrintOperation">GtkPrintOperation</a> *op,
                                                         <a
href="/usr/share/gtk-doc/html/glib/glib-Error-Reporting.html#GError"
>GError</a> **error);</pre>
<p>
Call this when the result of a print operation is
<a class="link" href="gtk-High-level-Printing-API.html#GTK-PRINT-OPERATION-RESULT-ERROR:CAPS"><code class="literal">GTK_PRINT_OPERATION_RESULT_ERROR</code></a>, either as returned by 
<a class="link" href="gtk-High-level-Printing-API.html#gtk-print-operation-run"><code class="function">gtk_print_operation_run()</code></a>, or in the <a class="link" href="gtk-High-level-Printing-API.html#GtkPrintOperation-done"><span class="type">"done"</span></a> signal 
handler. The returned <a
href="/usr/share/gtk-doc/html/glib/glib-Error-Reporting.html#GError"
><span class="type">GError</span></a> will contain more details on what went wrong.</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>op</code></em>&#160;:</span></p></td>
<td> a <a class="link" href="gtk-High-level-Printing-API.html#GtkPrintOperation"><span class="type">GtkPrintOperation</span></a>
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>error</code></em>&#160;:</span></p></td>
<td> return location for the error
</td>
</tr>
</tbody>
</table></div>
<p class="since">Since  2.10
</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id4130383"></a><h3>
<a name="gtk-print-operation-set-default-page-setup"></a>gtk_print_operation_set_default_page_setup ()</h3>
<a class="indexterm" name="id4130399"></a><pre class="programlisting">void                gtk_print_operation_set_default_page_setup
                                                        (<a class="link" href="gtk-High-level-Printing-API.html#GtkPrintOperation">GtkPrintOperation</a> *op,
                                                         <a class="link" href="GtkPageSetup.html" title="GtkPageSetup">GtkPageSetup</a> *default_page_setup);</pre>
<p>
Makes <em class="parameter"><code>default_page_setup</code></em> the default page setup for <em class="parameter"><code>op</code></em>.
</p>
<p>
This page setup will be used by <a class="link" href="gtk-High-level-Printing-API.html#gtk-print-operation-run"><code class="function">gtk_print_operation_run()</code></a>,
but it can be overridden on a per-page basis by connecting
to the <a class="link" href="gtk-High-level-Printing-API.html#GtkPrintOperation-request-page-setup"><span class="type">"request-page-setup"</span></a> signal.</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>op</code></em>&#160;:</span></p></td>
<td> a <a class="link" href="gtk-High-level-Printing-API.html#GtkPrintOperation"><span class="type">GtkPrintOperation</span></a>
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>default_page_setup</code></em>&#160;:</span></p></td>
<td> a <a class="link" href="GtkPageSetup.html" title="GtkPageSetup"><span class="type">GtkPageSetup</span></a>, or <a
href="/usr/share/gtk-doc/html/liboil/liboil-liboiljunk.html#NULL:CAPS"
><code class="literal">NULL</code></a>
</td>
</tr>
</tbody>
</table></div>
<p class="since">Since  2.10
</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id4130543"></a><h3>
<a name="gtk-print-operation-get-default-page-setup"></a>gtk_print_operation_get_default_page_setup ()</h3>
<a class="indexterm" name="id4130559"></a><pre class="programlisting"><a class="link" href="GtkPageSetup.html" title="GtkPageSetup">GtkPageSetup</a>*       gtk_print_operation_get_default_page_setup
                                                        (<a class="link" href="gtk-High-level-Printing-API.html#GtkPrintOperation">GtkPrintOperation</a> *op);</pre>
<p>
Returns the default page setup, see 
<a class="link" href="gtk-High-level-Printing-API.html#gtk-print-operation-set-default-page-setup"><code class="function">gtk_print_operation_set_default_page_setup()</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>op</code></em>&#160;:</span></p></td>
<td> a <a class="link" href="gtk-High-level-Printing-API.html#GtkPrintOperation"><span class="type">GtkPrintOperation</span></a>
</td>
</tr>
<tr>