<?xml version="1.0"?>
<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
               "http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd" [
<!ENTITY % local.common.attrib "xmlns:xi  CDATA  #FIXED 'http://www.w3.org/2003/XInclude'">
<!ENTITY version SYSTEM "version.xml">
<!ENTITY pi "&#960;">
<!ENTITY solidus "&#8260;">
]>
<refentry id="GtkPrintJob">
<refmeta>
<refentrytitle role="top_of_page" id="GtkPrintJob.top_of_page">GtkPrintJob</refentrytitle>
<manvolnum>3</manvolnum>
<refmiscinfo>GTK4 Library</refmiscinfo>
</refmeta>
<refnamediv>
<refname>GtkPrintJob</refname>
<refpurpose>Represents a print job</refpurpose>
</refnamediv>

<refsect1 id="GtkPrintJob.functions" role="functions_proto">
<title role="functions_proto.title">Functions</title>
<informaltable pgwide="1" frame="none">
<tgroup cols="2">
<colspec colname="functions_proto_type" colwidth="150px"/>
<colspec colname="functions_proto_name"/>
<tbody>
<row><entry role="function_type"><link linkend="void"><returnvalue>void</returnvalue></link>
</entry><entry role="function_name"><phrase role="c_punctuation">(</phrase><link linkend="GtkPrintJobCompleteFunc">*GtkPrintJobCompleteFunc</link><phrase role="c_punctuation">)</phrase>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="GtkPrintJob"><returnvalue>GtkPrintJob</returnvalue></link>&#160;*
</entry><entry role="function_name"><link linkend="gtk-print-job-new">gtk_print_job_new</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="GtkPrintSettings"><returnvalue>GtkPrintSettings</returnvalue></link>&#160;*
</entry><entry role="function_name"><link linkend="gtk-print-job-get-settings">gtk_print_job_get_settings</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="GtkPrinter"><returnvalue>GtkPrinter</returnvalue></link>&#160;*
</entry><entry role="function_name"><link linkend="gtk-print-job-get-printer">gtk_print_job_get_printer</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type">const <link linkend="gchar"><returnvalue>gchar</returnvalue></link>&#160;*
</entry><entry role="function_name"><link linkend="gtk-print-job-get-title">gtk_print_job_get_title</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="GtkPrintStatus"><returnvalue>GtkPrintStatus</returnvalue></link>
</entry><entry role="function_name"><link linkend="gtk-print-job-get-status">gtk_print_job_get_status</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="gboolean"><returnvalue>gboolean</returnvalue></link>
</entry><entry role="function_name"><link linkend="gtk-print-job-set-source-file">gtk_print_job_set_source_file</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="gboolean"><returnvalue>gboolean</returnvalue></link>
</entry><entry role="function_name"><link linkend="gtk-print-job-set-source-fd">gtk_print_job_set_source_fd</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="cairo-surface-t"><returnvalue>cairo_surface_t</returnvalue></link>&#160;*
</entry><entry role="function_name"><link linkend="gtk-print-job-get-surface">gtk_print_job_get_surface</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="void"><returnvalue>void</returnvalue></link>
</entry><entry role="function_name"><link linkend="gtk-print-job-send">gtk_print_job_send</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="void"><returnvalue>void</returnvalue></link>
</entry><entry role="function_name"><link linkend="gtk-print-job-set-track-print-status">gtk_print_job_set_track_print_status</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="gboolean"><returnvalue>gboolean</returnvalue></link>
</entry><entry role="function_name"><link linkend="gtk-print-job-get-track-print-status">gtk_print_job_get_track_print_status</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="GtkPrintPages"><returnvalue>GtkPrintPages</returnvalue></link>
</entry><entry role="function_name"><link linkend="gtk-print-job-get-pages">gtk_print_job_get_pages</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="void"><returnvalue>void</returnvalue></link>
</entry><entry role="function_name"><link linkend="gtk-print-job-set-pages">gtk_print_job_set_pages</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="GtkPageRange"><returnvalue>GtkPageRange</returnvalue></link>&#160;*
</entry><entry role="function_name"><link linkend="gtk-print-job-get-page-ranges">gtk_print_job_get_page_ranges</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="void"><returnvalue>void</returnvalue></link>
</entry><entry role="function_name"><link linkend="gtk-print-job-set-page-ranges">gtk_print_job_set_page_ranges</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="GtkPageSet"><returnvalue>GtkPageSet</returnvalue></link>
</entry><entry role="function_name"><link linkend="gtk-print-job-get-page-set">gtk_print_job_get_page_set</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="void"><returnvalue>void</returnvalue></link>
</entry><entry role="function_name"><link linkend="gtk-print-job-set-page-set">gtk_print_job_set_page_set</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="gint"><returnvalue>gint</returnvalue></link>
</entry><entry role="function_name"><link linkend="gtk-print-job-get-num-copies">gtk_print_job_get_num_copies</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="void"><returnvalue>void</returnvalue></link>
</entry><entry role="function_name"><link linkend="gtk-print-job-set-num-copies">gtk_print_job_set_num_copies</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="gdouble"><returnvalue>gdouble</returnvalue></link>
</entry><entry role="function_name"><link linkend="gtk-print-job-get-scale">gtk_print_job_get_scale</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="void"><returnvalue>void</returnvalue></link>
</entry><entry role="function_name"><link linkend="gtk-print-job-set-scale">gtk_print_job_set_scale</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="guint"><returnvalue>guint</returnvalue></link>
</entry><entry role="function_name"><link linkend="gtk-print-job-get-n-up">gtk_print_job_get_n_up</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="void"><returnvalue>void</returnvalue></link>
</entry><entry role="function_name"><link linkend="gtk-print-job-set-n-up">gtk_print_job_set_n_up</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="GtkNumberUpLayout"><returnvalue>GtkNumberUpLayout</returnvalue></link>
</entry><entry role="function_name"><link linkend="gtk-print-job-get-n-up-layout">gtk_print_job_get_n_up_layout</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="void"><returnvalue>void</returnvalue></link>
</entry><entry role="function_name"><link linkend="gtk-print-job-set-n-up-layout">gtk_print_job_set_n_up_layout</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="gboolean"><returnvalue>gboolean</returnvalue></link>
</entry><entry role="function_name"><link linkend="gtk-print-job-get-rotate">gtk_print_job_get_rotate</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="void"><returnvalue>void</returnvalue></link>
</entry><entry role="function_name"><link linkend="gtk-print-job-set-rotate">gtk_print_job_set_rotate</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="gboolean"><returnvalue>gboolean</returnvalue></link>
</entry><entry role="function_name"><link linkend="gtk-print-job-get-collate">gtk_print_job_get_collate</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="void"><returnvalue>void</returnvalue></link>
</entry><entry role="function_name"><link linkend="gtk-print-job-set-collate">gtk_print_job_set_collate</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="gboolean"><returnvalue>gboolean</returnvalue></link>
</entry><entry role="function_name"><link linkend="gtk-print-job-get-reverse">gtk_print_job_get_reverse</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="void"><returnvalue>void</returnvalue></link>
</entry><entry role="function_name"><link linkend="gtk-print-job-set-reverse">gtk_print_job_set_reverse</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>

</tbody>
</tgroup>
</informaltable>
</refsect1>
<refsect1 id="GtkPrintJob.properties" role="properties">
<title role="properties.title">Properties</title>
<informaltable frame="none">
<tgroup cols="3">
<colspec colname="properties_type" colwidth="150px"/>
<colspec colname="properties_name" colwidth="300px"/>
<colspec colname="properties_flags" colwidth="200px"/>
<tbody>
<row><entry role="property_type"><link linkend="GtkPageSetup"><type>GtkPageSetup</type></link>&#160;*</entry><entry role="property_name"><link linkend="GtkPrintJob--page-setup">page-setup</link></entry><entry role="property_flags">Read / Write / Construct&#160;Only</entry></row>
<row><entry role="property_type"><link linkend="GtkPrinter"><type>GtkPrinter</type></link>&#160;*</entry><entry role="property_name"><link linkend="GtkPrintJob--printer">printer</link></entry><entry role="property_flags">Read / Write / Construct&#160;Only</entry></row>
<row><entry role="property_type"><link linkend="GtkPrintSettings"><type>GtkPrintSettings</type></link>&#160;*</entry><entry role="property_name"><link linkend="GtkPrintJob--settings">settings</link></entry><entry role="property_flags">Read / Write / Construct&#160;Only</entry></row>
<row><entry role="property_type"><link linkend="gchar"><type>gchar</type></link>&#160;*</entry><entry role="property_name"><link linkend="GtkPrintJob--title">title</link></entry><entry role="property_flags">Read / Write / Construct&#160;Only</entry></row>
<row><entry role="property_type"><link linkend="gboolean"><type>gboolean</type></link></entry><entry role="property_name"><link linkend="GtkPrintJob--track-print-status">track-print-status</link></entry><entry role="property_flags">Read / Write</entry></row>

</tbody>
</tgroup>
</informaltable>
</refsect1>
<refsect1 id="GtkPrintJob.signals" role="signal_proto">
<title role="signal_proto.title">Signals</title>
<informaltable frame="none">
<tgroup cols="3">
<colspec colname="signal_proto_type" colwidth="150px"/>
<colspec colname="signal_proto_name" colwidth="300px"/>
<colspec colname="signal_proto_flags" colwidth="200px"/>
<tbody>
<row><entry role="signal_type"><link linkend="void"><returnvalue>void</returnvalue></link></entry><entry role="signal_name"><link linkend="GtkPrintJob-status-changed">status-changed</link></entry><entry role="signal_flags"><link linkend="G-SIGNAL-RUN-LAST:CAPS">Run Last</link></entry></row>

</tbody>
</tgroup>
</informaltable>
</refsect1>
<refsect1 id="GtkPrintJob.other" role="other_proto">
<title role="other_proto.title">Types and Values</title>
<informaltable pgwide="1" frame="none">
<tgroup cols="2">
<colspec colname="other_proto_type" colwidth="150px"/>
<colspec colname="other_proto_name"/>
<tbody>
<row><entry role="datatype_keyword"></entry><entry role="function_name"><link linkend="GtkPrintJob-struct">GtkPrintJob</link></entry></row>

</tbody>
</tgroup>
</informaltable>
</refsect1>
<refsect1 id="GtkPrintJob.object-hierarchy" role="object_hierarchy">
<title role="object_hierarchy.title">Object Hierarchy</title>
<screen>    <link linkend="GObject">GObject</link>
    <phrase role="lineart">&#9584;&#9472;&#9472;</phrase> GtkPrintJob
</screen>
</refsect1>

<refsect1 id="GtkPrintJob.includes"><title>Includes</title><synopsis>#include &lt;gtk/gtkunixprint.h&gt;
</synopsis></refsect1>

<refsect1 id="GtkPrintJob.description" role="desc">
<title role="desc.title">Description</title>
<para>A <link linkend="GtkPrintJob"><type>GtkPrintJob</type></link> object represents a job that is sent to a
printer. You only need to deal directly with print jobs if
you use the non-portable <link linkend="GtkPrintUnixDialog"><type>GtkPrintUnixDialog</type></link> API.</para>
<para>Use <link linkend="gtk-print-job-get-surface"><function>gtk_print_job_get_surface()</function></link> to obtain the cairo surface
onto which the pages must be drawn. Use <link linkend="gtk-print-job-send"><function>gtk_print_job_send()</function></link>
to send the finished job to the printer. If you don’t use cairo
<link linkend="GtkPrintJob"><type>GtkPrintJob</type></link> also supports printing of manually generated postscript,
via <link linkend="gtk-print-job-set-source-file"><function>gtk_print_job_set_source_file()</function></link>.</para>

</refsect1>
<refsect1 id="GtkPrintJob.functions_details" role="details">
<title role="details.title">Functions</title>
<refsect2 id="GtkPrintJobCompleteFunc" role="function">
<title>GtkPrintJobCompleteFunc&#160;()</title>
<indexterm zone="GtkPrintJobCompleteFunc"><primary>GtkPrintJobCompleteFunc</primary></indexterm>
<programlisting language="C"><link linkend="void"><returnvalue>void</returnvalue></link>
<phrase role="c_punctuation">(</phrase>*GtkPrintJobCompleteFunc<phrase role="c_punctuation">)</phrase> (<parameter><link linkend="GtkPrintJob"><type>GtkPrintJob</type></link> *print_job</parameter>,
                            <parameter><link linkend="gpointer"><type>gpointer</type></link> user_data</parameter>,
                            <parameter>const <link linkend="GError"><type>GError</type></link> *error</parameter>);</programlisting>
<para>The type of callback that is passed to <link linkend="gtk-print-job-send"><function>gtk_print_job_send()</function></link>.
It is called when the print job has been completely sent.</para>
<refsect3 id="GtkPrintJobCompleteFunc.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>print_job</para></entry>
<entry role="parameter_description"><para>the <link linkend="GtkPrintJob"><type>GtkPrintJob</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>user_data</para></entry>
<entry role="parameter_description"><para>user data that has been passed to <link linkend="gtk-print-job-send"><function>gtk_print_job_send()</function></link></para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>error</para></entry>
<entry role="parameter_description"><para>a <link linkend="GError"><type>GError</type></link> that contains error information if the sending
of the print job failed, otherwise <link linkend="NULL:CAPS"><literal>NULL</literal></link></para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3></refsect2>
<refsect2 id="gtk-print-job-new" role="function">
<title>gtk_print_job_new&#160;()</title>
<indexterm zone="gtk-print-job-new"><primary>gtk_print_job_new</primary></indexterm>
<programlisting language="C"><link linkend="GtkPrintJob"><returnvalue>GtkPrintJob</returnvalue></link>&#160;*
gtk_print_job_new (<parameter>const <link linkend="gchar"><type>gchar</type></link> *title</parameter>,
                   <parameter><link linkend="GtkPrinter"><type>GtkPrinter</type></link> *printer</parameter>,
                   <parameter><link linkend="GtkPrintSettings"><type>GtkPrintSettings</type></link> *settings</parameter>,
                   <parameter><link linkend="GtkPageSetup"><type>GtkPageSetup</type></link> *page_setup</parameter>);</programlisting>
<para>Creates a new <link linkend="GtkPrintJob"><type>GtkPrintJob</type></link>.</para>
<refsect3 id="gtk-print-job-new.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>title</para></entry>
<entry role="parameter_description"><para>the job title</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>printer</para></entry>
<entry role="parameter_description"><para>a <link linkend="GtkPrinter"><type>GtkPrinter</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>settings</para></entry>
<entry role="parameter_description"><para>a <link linkend="GtkPrintSettings"><type>GtkPrintSettings</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>page_setup</para></entry>
<entry role="parameter_description"><para>a <link linkend="GtkPageSetup"><type>GtkPageSetup</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><refsect3 id="gtk-print-job-new.returns" role="returns">
<title>Returns</title>
<para> a new <link linkend="GtkPrintJob"><type>GtkPrintJob</type></link></para>
</refsect3></refsect2>
<refsect2 id="gtk-print-job-get-settings" role="function">
<title>gtk_print_job_get_settings&#160;()</title>
<indexterm zone="gtk-print-job-get-settings"><primary>gtk_print_job_get_settings</primary></indexterm>
<programlisting language="C"><link linkend="GtkPrintSettings"><returnvalue>GtkPrintSettings</returnvalue></link>&#160;*
gtk_print_job_get_settings (<parameter><link linkend="GtkPrintJob"><type>GtkPrintJob</type></link> *job</parameter>);</programlisting>
<para>Gets the <link linkend="GtkPrintSettings"><type>GtkPrintSettings</type></link> of the print job.</para>
<refsect3 id="gtk-print-job-get-settings.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>job</para></entry>
<entry role="parameter_description"><para>a <link linkend="GtkPrintJob"><type>GtkPrintJob</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><refsect3 id="gtk-print-job-get-settings.returns" role="returns">
<title>Returns</title>
<para>the settings of <parameter>job</parameter>
. </para>
<para><emphasis role="annotation">[<acronym>transfer none</acronym>]</emphasis></para>
</refsect3></refsect2>
<refsect2 id="gtk-print-job-get-printer" role="function">
<title>gtk_print_job_get_printer&#160;()</title>
<indexterm zone="gtk-print-job-get-printer"><primary>gtk_print_job_get_printer</primary></indexterm>
<programlisting language="C"><link linkend="GtkPrinter"><returnvalue>GtkPrinter</returnvalue></link>&#160;*
gtk_print_job_get_printer (<parameter><link linkend="GtkPrintJob"><type>GtkPrintJob</type></link> *job</parameter>);</programlisting>
<para>Gets the <link linkend="GtkPrinter"><type>GtkPrinter</type></link> of the print job.</para>
<refsect3 id="gtk-print-job-get-printer.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>job</para></entry>
<entry role="parameter_description"><para>a <link linkend="GtkPrintJob"><type>GtkPrintJob</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><refsect3 id="gtk-print-job-get-printer.returns" role="returns">
<title>Returns</title>
<para>the printer of <parameter>job</parameter>
. </para>
<para><emphasis role="annotation">[<acronym>transfer none</acronym>]</emphasis></para>
</refsect3></refsect2>
<refsect2 id="gtk-print-job-get-title" role="function">
<title>gtk_print_job_get_title&#160;()</title>
<indexterm zone="gtk-print-job-get-title"><primary>gtk_print_job_get_title</primary></indexterm>
<programlisting language="C">const <link linkend="gchar"><returnvalue>gchar</returnvalue></link>&#160;*
gtk_print_job_get_title (<parameter><link linkend="GtkPrintJob"><type>GtkPrintJob</type></link> *job</parameter>);</programlisting>
<para>Gets the job title.</para>
<refsect3 id="gtk-print-job-get-title.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>job</para></entry>
<entry role="parameter_description"><para>a <link linkend="GtkPrintJob"><type>GtkPrintJob</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><refsect3 id="gtk-print-job-get-title.returns" role="returns">
<title>Returns</title>
<para> the title of <parameter>job</parameter>
</para>
</refsect3></refsect2>
<refsect2 id="gtk-print-job-get-status" role="function">
<title>gtk_print_job_get_status&#160;()</title>
<indexterm zone="gtk-print-job-get-status"><primary>gtk_print_job_get_status</primary></indexterm>
<programlisting language="C"><link linkend="GtkPrintStatus"><returnvalue>GtkPrintStatus</returnvalue></link>
gtk_print_job_get_status (<parameter><link linkend="GtkPrintJob"><type>GtkPrintJob</type></link> *job</parameter>);</programlisting>
<para>Gets the status of the print job.</para>
<refsect3 id="gtk-print-job-get-status.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>job</para></entry>
<entry role="parameter_description"><para>a <link linkend="GtkPrintJob"><type>GtkPrintJob</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><refsect3 id="gtk-print-job-get-status.returns" role="returns">
<title>Returns</title>
<para> the status of <parameter>job</parameter>
</para>
</refsect3></refsect2>
<refsect2 id="gtk-print-job-set-source-file" role="function">
<title>gtk_print_job_set_source_file&#160;()</title>
<indexterm zone="gtk-print-job-set-source-file"><primary>gtk_print_job_set_source_file</primary></indexterm>
<programlisting language="C"><link linkend="gboolean"><returnvalue>gboolean</returnvalue></link>
gtk_print_job_set_source_file (<parameter><link linkend="GtkPrintJob"><type>GtkPrintJob</type></link> *job</parameter>,
                               <parameter>const <link linkend="gchar"><type>gchar</type></link> *filename</parameter>,
                               <parameter><link linkend="GError"><type>GError</type></link> **error</parameter>);</programlisting>
<para>Make the <link linkend="GtkPrintJob"><type>GtkPrintJob</type></link> send an existing document to the 
printing system. The file can be in any format understood
by the platforms printing system (typically PostScript,
but on many platforms PDF may work too). See 
<link linkend="gtk-printer-accepts-pdf"><function>gtk_printer_accepts_pdf()</function></link> and <link linkend="gtk-printer-accepts-ps"><function>gtk_printer_accepts_ps()</function></link>.</para>
<refsect3 id="gtk-print-job-set-source-file.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>job</para></entry>
<entry role="parameter_description"><para>a <link linkend="GtkPrintJob"><type>GtkPrintJob</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>filename</para></entry>
<entry role="parameter_description"><para>the file to be printed. </para></entry>
<entry role="parameter_annotations"><emphasis role="annotation">[<acronym>type</acronym> filename]</emphasis></entry></row>
<row><entry role="parameter_name"><para>error</para></entry>
<entry role="parameter_description"><para>return location for errors</para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><refsect3 id="gtk-print-job-set-source-file.returns" role="returns">
<title>Returns</title>
<para> <link linkend="FALSE:CAPS"><literal>FALSE</literal></link> if an error occurred</para>
</refsect3></refsect2>
<refsect2 id="gtk-print-job-set-source-fd" role="function">
<title>gtk_print_job_set_source_fd&#160;()</title>
<indexterm zone="gtk-print-job-set-source-fd"><primary>gtk_print_job_set_source_fd</primary></indexterm>
<programlisting language="C"><link linkend="gboolean"><returnvalue>gboolean</returnvalue></link>
gtk_print_job_set_source_fd (<parameter><link linkend="GtkPrintJob"><type>GtkPrintJob</type></link> *job</parameter>,
                             <parameter><link linkend="int"><type>int</type></link> fd</parameter>,
                             <parameter><link linkend="GError"><type>GError</type></link> **error</parameter>);</programlisting>
<para>Make the <link linkend="GtkPrintJob"><type>GtkPrintJob</type></link> send an existing document to the
printing system. The file can be in any format understood
by the platforms printing system (typically PostScript,
but on many platforms PDF may work too). See
<link linkend="gtk-printer-accepts-pdf"><function>gtk_printer_accepts_pdf()</function></link> and <link linkend="gtk-printer-accepts-ps"><function>gtk_printer_accepts_ps()</function></link>.</para>
<para>This is similar to <link linkend="gtk-print-job-set-source-file"><function>gtk_print_job_set_source_file()</function></link>,
but takes expects an open file descriptor for the file,
instead of a filename.</para>
<refsect3 id="gtk-print-job-set-source-fd.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>job</para></entry>
<entry role="parameter_description"><para>a <link linkend="GtkPrintJob"><type>GtkPrintJob</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>fd</para></entry>
<entry role="parameter_description"><para>a file descriptor</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>error</para></entry>
<entry role="parameter_description"><para>return location for errors</para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><refsect3 id="gtk-print-job-set-source-fd.returns" role="returns">
<title>Returns</title>
<para> <link linkend="FALSE:CAPS"><literal>FALSE</literal></link> if an error occurred</para>
</refsect3></refsect2>
<refsect2 id="gtk-print-job-get-surface" role="function">
<title>gtk_print_job_get_surface&#160;()</title>
<indexterm zone="gtk-print-job-get-surface"><primary>gtk_print_job_get_surface</primary></indexterm>
<programlisting language="C"><link linkend="cairo-surface-t"><returnvalue>cairo_surface_t</returnvalue></link>&#160;*
gtk_print_job_get_surface (<parameter><link linkend="GtkPrintJob"><type>GtkPrintJob</type></link> *job</parameter>,
                           <parameter><link linkend="GError"><type>GError</type></link> **error</parameter>);</programlisting>
<para>Gets a cairo surface onto which the pages of
the print job should be rendered.</para>
<refsect3 id="gtk-print-job-get-surface.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>job</para></entry>
<entry role="parameter_description"><para>a <link linkend="GtkPrintJob"><type>GtkPrintJob</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>error</para></entry>
<entry role="parameter_description"><para>return location for errors, or <link linkend="NULL:CAPS"><literal>NULL</literal></link>. </para></entry>
<entry role="parameter_annotations"><emphasis role="annotation">[<acronym>allow-none</acronym>]</emphasis></entry></row>
</tbody></tgroup></informaltable>
</refsect3><refsect3 id="gtk-print-job-get-surface.returns" role="returns">
<title>Returns</title>
<para>the cairo surface of <parameter>job</parameter>
. </para>
<para><emphasis role="annotation">[<acronym>transfer none</acronym>]</emphasis></para>
</refsect3></refsect2>
<refsect2 id="gtk-print-job-send" role="function">
<title>gtk_print_job_send&#160;()</title>
<indexterm zone="gtk-print-job-send"><primary>gtk_print_job_send</primary></indexterm>
<programlisting language="C"><link linkend="void"><returnvalue>void</returnvalue></link>
gtk_print_job_send (<parameter><link linkend="GtkPrintJob"><type>GtkPrintJob</type></link> *job</parameter>,
                    <parameter><link linkend="GtkPrintJobCompleteFunc"><type>GtkPrintJobCompleteFunc</type></link> callback</parameter>,
                    <parameter><link linkend="gpointer"><type>gpointer</type></link> user_data</parameter>,
                    <parameter><link linkend="GDestroyNotify"><type>GDestroyNotify</type></link> dnotify</parameter>);</programlisting>
<para>Sends the print job off to the printer.</para>
<refsect3 id="gtk-print-job-send.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>job</para></entry>
<entry role="parameter_description"><para>a GtkPrintJob</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>callback</para></entry>
<entry role="parameter_description"><para>function to call when the job completes or an error occurs</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>user_data</para></entry>
<entry role="parameter_description"><para>user data that gets passed to <parameter>callback</parameter>
. </para></entry>
<entry role="parameter_annotations"><emphasis role="annotation">[<acronym>closure</acronym>]</emphasis></entry></row>
<row><entry role="parameter_name"><para>dnotify</para></entry>
<entry role="parameter_description"><para>destroy notify for <parameter>user_data</parameter>
</para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3></refsect2>
<refsect2 id="gtk-print-job-set-track-print-status" role="function">
<title>gtk_print_job_set_track_print_status&#160;()</title>
<indexterm zone="gtk-print-job-set-track-print-status"><primary>gtk_print_job_set_track_print_status</primary></indexterm>
<programlisting language="C"><link linkend="void"><returnvalue>void</returnvalue></link>
gtk_print_job_set_track_print_status (<parameter><link linkend="GtkPrintJob"><type>GtkPrintJob</type></link> *job</parameter>,
                                      <parameter><link linkend="gboolean"><type>gboolean</type></link> track_status</parameter>);</programlisting>
<para>If track_status is <link linkend="TRUE:CAPS"><literal>TRUE</literal></link>, the print job will try to continue report
on the status of the print job in the printer queues and printer. This
can allow your application to show things like “out of paper” issues,
and when the print job actually reaches the printer.</para>
<para>This function is often implemented using some form of polling, so it should
not be enabled unless needed.</para>
<refsect3 id="gtk-print-job-set-track-print-status.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>job</para></entry>
<entry role="parameter_description"><para>a <link linkend="GtkPrintJob"><type>GtkPrintJob</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>track_status</para></entry>
<entry role="parameter_description"><para><link linkend="TRUE:CAPS"><literal>TRUE</literal></link> to track status after printing</para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3></refsect2>
<refsect2 id="gtk-print-job-get-track-print-status" role="function">
<title>gtk_print_job_get_track_print_status&#160;()</title>
<indexterm zone="gtk-print-job-get-track-print-status"><primary>gtk_print_job_get_track_print_status</primary></indexterm>
<programlisting language="C"><link linkend="gboolean"><returnvalue>gboolean</returnvalue></link>
gtk_print_job_get_track_print_status (<parameter><link linkend="GtkPrintJob"><type>GtkPrintJob</type></link> *job</parameter>);</programlisting>
<para>Returns wheter jobs will be tracked after printing.
For details, see <link linkend="gtk-print-job-set-track-print-status"><function>gtk_print_job_set_track_print_status()</function></link>.</para>
<refsect3 id="gtk-print-job-get-track-print-status.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>job</para></entry>
<entry role="parameter_description"><para>a <link linkend="GtkPrintJob"><type>GtkPrintJob</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><refsect3 id="gtk-print-job-get-track-print-status.returns" role="returns">
<title>Returns</title>
<para> <link linkend="TRUE:CAPS"><literal>TRUE</literal></link> if print job status will be reported after printing</para>
</refsect3></refsect2>
<refsect2 id="gtk-print-job-get-pages" role="function">
<title>gtk_print_job_get_pages&#160;()</title>
<indexterm zone="gtk-print-job-get-pages"><primary>gtk_print_job_get_pages</primary></indexterm>
<programlisting language="C"><link linkend="GtkPrintPages"><returnvalue>GtkPrintPages</returnvalue></link>
gtk_print_job_get_pages (<parameter><link linkend="GtkPrintJob"><type>GtkPrintJob</type></link> *job</parameter>);</programlisting>
<para>Gets the <link linkend="GtkPrintPages"><type>GtkPrintPages</type></link> setting for this job.</para>
<refsect3 id="gtk-print-job-get-pages.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>job</para></entry>
<entry role="parameter_description"><para>a <link linkend="GtkPrintJob"><type>GtkPrintJob</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><refsect3 id="gtk-print-job-get-pages.returns" role="returns">
<title>Returns</title>
<para> the <link linkend="GtkPrintPages"><type>GtkPrintPages</type></link> setting</para>
</refsect3></refsect2>
<refsect2 id="gtk-print-job-set-pages" role="function">
<title>gtk_print_job_set_pages&#160;()</title>
<indexterm zone="gtk-print-job-set-pages"><primary>gtk_print_job_set_pages</primary></indexterm>
<programlisting language="C"><link linkend="void"><returnvalue>void</returnvalue></link>
gtk_print_job_set_pages (<parameter><link linkend="GtkPrintJob"><type>GtkPrintJob</type></link> *job</parameter>,
                         <parameter><link linkend="GtkPrintPages"><type>GtkPrintPages</type></link> pages</parameter>);</programlisting>
<para>Sets the <link linkend="GtkPrintPages"><type>GtkPrintPages</type></link> setting for this job.</para>
<refsect3 id="gtk-print-job-set-pages.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>job</para></entry>
<entry role="parameter_description"><para>a <link linkend="GtkPrintJob"><type>GtkPrintJob</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>pages</para></entry>
<entry role="parameter_description"><para>the <link linkend="GtkPrintPages"><type>GtkPrintPages</type></link> setting</para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3></refsect2>
<refsect2 id="gtk-print-job-get-page-ranges" role="function">
<title>gtk_print_job_get_page_ranges&#160;()</title>
<indexterm zone="gtk-print-job-get-page-ranges"><primary>gtk_print_job_get_page_ranges</primary></indexterm>
<programlisting language="C"><link linkend="GtkPageRange"><returnvalue>GtkPageRange</returnvalue></link>&#160;*
gtk_print_job_get_page_ranges (<parameter><link linkend="GtkPrintJob"><type>GtkPrintJob</type></link> *job</parameter>,
                               <parameter><link linkend="gint"><type>gint</type></link> *n_ranges</parameter>);</programlisting>
<para>Gets the page ranges for this job.</para>
<refsect3 id="gtk-print-job-get-page-ranges.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>job</para></entry>
<entry role="parameter_description"><para>a <link linkend="GtkPrintJob"><type>GtkPrintJob</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>n_ranges</para></entry>
<entry role="parameter_description"><para>return location for the number of ranges. </para></entry>
<entry role="parameter_annotations"><emphasis role="annotation">[<acronym>out</acronym>]</emphasis></entry></row>
</tbody></tgroup></informaltable>
</refsect3><refsect3 id="gtk-print-job-get-page-ranges.returns" role="returns">
<title>Returns</title>
<para>a pointer to an
array of <link linkend="GtkPageRange"><type>GtkPageRange</type></link> structs. </para>
<para><emphasis role="annotation">[<acronym>array</acronym> length=n_ranges][<acronym>transfer none</acronym>]</emphasis></para>
</refsect3></refsect2>
<refsect2 id="gtk-print-job-set-page-ranges" role="function">
<title>gtk_print_job_set_page_ranges&#160;()</title>
<indexterm zone="gtk-print-job-set-page-ranges"><primary>gtk_print_job_set_page_ranges</primary></indexterm>
<programlisting language="C"><link linkend="void"><returnvalue>void</returnvalue></link>
gtk_print_job_set_page_ranges (<parameter><link linkend="GtkPrintJob"><type>GtkPrintJob</type></link> *job</parameter>,
                               <parameter><link linkend="GtkPageRange"><type>GtkPageRange</type></link> *ranges</parameter>,
                               <parameter><link linkend="gint"><type>gint</type></link> n_ranges</parameter>);</programlisting>
<para>Sets the page ranges for this job.</para>
<refsect3 id="gtk-print-job-set-page-ranges.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>job</para></entry>
<entry role="parameter_description"><para>a <link linkend="GtkPrintJob"><type>GtkPrintJob</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>ranges</para></entry>
<entry role="parameter_description"><para>pointer to an array of
<link linkend="GtkPageRange"><type>GtkPageRange</type></link> structs. </para></entry>
<entry role="parameter_annotations"><emphasis role="annotation">[<acronym>array</acronym> length=n_ranges][<acronym>transfer full</acronym>]</emphasis></entry></row>
<row><entry role="parameter_name"><para>n_ranges</para></entry>
<entry role="parameter_description"><para>the length of the <parameter>ranges</parameter>
array</para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3></refsect2>
<refsect2 id="gtk-print-job-get-page-set" role="function">
<title>gtk_print_job_get_page_set&#160;()</title>
<indexterm zone="gtk-print-job-get-page-set"><primary>gtk_print_job_get_page_set</primary></indexterm>
<programlisting language="C"><link linkend="GtkPageSet"><returnvalue>GtkPageSet</returnvalue></link>
gtk_print_job_get_page_set (<parameter><link linkend="GtkPrintJob"><type>GtkPrintJob</type></link> *job</parameter>);</programlisting>
<para>Gets the <link linkend="GtkPageSet"><type>GtkPageSet</type></link> setting for this job.</para>
<refsect3 id="gtk-print-job-get-page-set.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>job</para></entry>
<entry role="parameter_description"><para>a <link linkend="GtkPrintJob"><type>GtkPrintJob</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><refsect3 id="gtk-print-job-get-page-set.returns" role="returns">
<title>Returns</title>
<para> the <link linkend="GtkPageSet"><type>GtkPageSet</type></link> setting</para>
</refsect3></refsect2>
<refsect2 id="gtk-print-job-set-page-set" role="function">
<title>gtk_print_job_set_page_set&#160;()</title>
<indexterm zone="gtk-print-job-set-page-set"><primary>gtk_print_job_set_page_set</primary></indexterm>
<programlisting language="C"><link linkend="void"><returnvalue>void</returnvalue></link>
gtk_print_job_set_page_set (<parameter><link linkend="GtkPrintJob"><type>GtkPrintJob</type></link> *job</parameter>,
                            <parameter><link linkend="GtkPageSet"><type>GtkPageSet</type></link> page_set</parameter>);</programlisting>
<para>Sets the <link linkend="GtkPageSet"><type>GtkPageSet</type></link> setting for this job.</para>
<refsect3 id="gtk-print-job-set-page-set.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>job</para></entry>
<entry role="parameter_description"><para>a <link linkend="GtkPrintJob"><type>GtkPrintJob</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>page_set</para></entry>
<entry role="parameter_description"><para>a <link linkend="GtkPageSet"><type>GtkPageSet</type></link> setting</para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3></refsect2>
<refsect2 id="gtk-print-job-get-num-copies" role="function">
<title>gtk_print_job_get_num_copies&#160;()</title>
<indexterm zone="gtk-print-job-get-num-copies"><primary>gtk_print_job_get_num_copies</primary></indexterm>
<programlisting language="C"><link linkend="gint"><returnvalue>gint</returnvalue></link>
gtk_print_job_get_num_copies (<parameter><link linkend="GtkPrintJob"><type>GtkPrintJob</type></link> *job</parameter>);</programlisting>
<para>Gets the number of copies of this job.</para>
<refsect3 id="gtk-print-job-get-num-copies.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>job</para></entry>
<entry role="parameter_description"><para>a <link linkend="GtkPrintJob"><type>GtkPrintJob</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><refsect3 id="gtk-print-job-get-num-copies.returns" role="returns">
<title>Returns</title>
<para> the number of copies</para>
</refsect3></refsect2>
<refsect2 id="gtk-print-job-set-num-copies" role="function">
<title>gtk_print_job_set_num_copies&#160;()</title>
<indexterm zone="gtk-print-job-set-num-copies"><primary>gtk_print_job_set_num_copies</primary></indexterm>
<programlisting language="C"><link linkend="void"><returnvalue>void</returnvalue></link>
gtk_print_job_set_num_copies (<parameter><link linkend="GtkPrintJob"><type>GtkPrintJob</type></link> *job</parameter>,
                              <parameter><link linkend="gint"><type>gint</type></link> num_copies</parameter>);</programlisting>
<para>Sets the number of copies for this job.</para>
<refsect3 id="gtk-print-job-set-num-copies.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>job</para></entry>
<entry role="parameter_description"><para>a <link linkend="GtkPrintJob"><type>GtkPrintJob</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>num_copies</para></entry>
<entry role="parameter_description"><para>the number of copies</para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3></refsect2>
<refsect2 id="gtk-print-job-get-scale" role="function">
<title>gtk_print_job_get_scale&#160;()</title>
<indexterm zone="gtk-print-job-get-scale"><primary>gtk_print_job_get_scale</primary></indexterm>
<programlisting language="C"><link linkend="gdouble"><returnvalue>gdouble</returnvalue></link>
gtk_print_job_get_scale (<parameter><link linkend="GtkPrintJob"><type>GtkPrintJob</type></link> *job</parameter>);</programlisting>
<para>Gets the scale for this job (where 1.0 means unscaled).</para>
<refsect3 id="gtk-print-job-get-scale.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>job</para></entry>
<entry role="parameter_description"><para>a <link linkend="GtkPrintJob"><type>GtkPrintJob</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><refsect3 id="gtk-print-job-get-scale.returns" role="returns">
<title>Returns</title>
<para> the scale</para>
</refsect3></refsect2>
<refsect2 id="gtk-print-job-set-scale" role="function">
<title>gtk_print_job_set_scale&#160;()</title>
<indexterm zone="gtk-print-job-set-scale"><primary>gtk_print_job_set_scale</primary></indexterm>
<programlisting language="C"><link linkend="void"><returnvalue>void</returnvalue></link>
gtk_print_job_set_scale (<parameter><link linkend="GtkPrintJob"><type>GtkPrintJob</type></link> *job</parameter>,
                         <parameter><link linkend="gdouble"><type>gdouble</type></link> scale</parameter>);</programlisting>
<para>Sets the scale for this job (where 1.0 means unscaled).</para>
<refsect3 id="gtk-print-job-set-scale.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>job</para></entry>
<entry role="parameter_description"><para>a <link linkend="GtkPrintJob"><type>GtkPrintJob</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>scale</para></entry>
<entry role="parameter_description"><para>the scale</para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3></refsect2>
<refsect2 id="gtk-print-job-get-n-up" role="function">
<title>gtk_print_job_get_n_up&#160;()</title>
<indexterm zone="gtk-print-job-get-n-up"><primary>gtk_print_job_get_n_up</primary></indexterm>
<programlisting language="C"><link linkend="guint"><returnvalue>guint</returnvalue></link>
gtk_print_job_get_n_up (<parameter><link linkend="GtkPrintJob"><type>GtkPrintJob</type></link> *job</parameter>);</programlisting>
<para>Gets the n-up setting for this job.</para>
<refsect3 id="gtk-print-job-get-n-up.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>job</para></entry>
<entry role="parameter_description"><para>a <link linkend="GtkPrintJob"><type>GtkPrintJob</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><refsect3 id="gtk-print-job-get-n-up.returns" role="returns">
<title>Returns</title>
<para> the n-up setting</para>
</refsect3></refsect2>
<refsect2 id="gtk-print-job-set-n-up" role="function">
<title>gtk_print_job_set_n_up&#160;()</title>
<indexterm zone="gtk-print-job-set-n-up"><primary>gtk_print_job_set_n_up</primary></indexterm>
<programlisting language="C"><link linkend="void"><returnvalue>void</returnvalue></link>
gtk_print_job_set_n_up (<parameter><link linkend="GtkPrintJob"><type>GtkPrintJob</type></link> *job</parameter>,
                        <parameter><link linkend="guint"><type>guint</type></link> n_up</parameter>);</programlisting>
<para>Sets the n-up setting for this job.</para>
<refsect3 id="gtk-print-job-set-n-up.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>job</para></entry>
<entry role="parameter_description"><para>a <link linkend="GtkPrintJob"><type>GtkPrintJob</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>n_up</para></entry>
<entry role="parameter_description"><para>the n-up value</para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3></refsect2>
<refsect2 id="gtk-print-job-get-n-up-layout" role="function">
<title>gtk_print_job_get_n_up_layout&#160;()</title>
<indexterm zone="gtk-print-job-get-n-up-layout"><primary>gtk_print_job_get_n_up_layout</primary></indexterm>
<programlisting language="C"><link linkend="GtkNumberUpLayout"><returnvalue>GtkNumberUpLayout</returnvalue></link>
gtk_print_job_get_n_up_layout (<parameter><link linkend="GtkPrintJob"><type>GtkPrintJob</type></link> *job</parameter>);</programlisting>
<para>Gets the n-up layout setting for this job.</para>
<refsect3 id="gtk-print-job-get-n-up-layout.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>job</para></entry>
<entry role="parameter_description"><para>a <link linkend="GtkPrintJob"><type>GtkPrintJob</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><refsect3 id="gtk-print-job-get-n-up-layout.returns" role="returns">
<title>Returns</title>
<para> the n-up layout</para>
</refsect3></refsect2>
<refsect2 id="gtk-print-job-set-n-up-layout" role="function">
<title>gtk_print_job_set_n_up_layout&#160;()</title>
<indexterm zone="gtk-print-job-set-n-up-layout"><primary>gtk_print_job_set_n_up_layout</primary></indexterm>
<programlisting language="C"><link linkend="void"><returnvalue>void</returnvalue></link>
gtk_print_job_set_n_up_layout (<parameter><link linkend="GtkPrintJob"><type>GtkPrintJob</type></link> *job</parameter>,
                               <parameter><link linkend="GtkNumberUpLayout"><type>GtkNumberUpLayout</type></link> layout</parameter>);</programlisting>
<para>Sets the n-up layout setting for this job.</para>
<refsect3 id="gtk-print-job-set-n-up-layout.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>job</para></entry>
<entry role="parameter_description"><para>a <link linkend="GtkPrintJob"><type>GtkPrintJob</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>layout</para></entry>
<entry role="parameter_description"><para>the n-up layout setting</para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3></refsect2>
<refsect2 id="gtk-print-job-get-rotate" role="function">
<title>gtk_print_job_get_rotate&#160;()</title>
<indexterm zone="gtk-print-job-get-rotate"><primary>gtk_print_job_get_rotate</primary></indexterm>
<programlisting language="C"><link linkend="gboolean"><returnvalue>gboolean</returnvalue></link>
gtk_print_job_get_rotate (<parameter><link linkend="GtkPrintJob"><type>GtkPrintJob</type></link> *job</parameter>);</programlisting>
<para>Gets whether the job is printed rotated.</para>
<refsect3 id="gtk-print-job-get-rotate.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>job</para></entry>
<entry role="parameter_description"><para>a <link linkend="GtkPrintJob"><type>GtkPrintJob</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><refsect3 id="gtk-print-job-get-rotate.returns" role="returns">
<title>Returns</title>
<para> whether the job is printed rotated</para>
</refsect3></refsect2>
<refsect2 id="gtk-print-job-set-rotate" role="function">
<title>gtk_print_job_set_rotate&#160;()</title>
<indexterm zone="gtk-print-job-set-rotate"><primary>gtk_print_job_set_rotate</primary></indexterm>
<programlisting language="C"><link linkend="void"><returnvalue>void</returnvalue></link>
gtk_print_job_set_rotate (<parameter><link linkend="GtkPrintJob"><type>GtkPrintJob</type></link> *job</parameter>,
                          <parameter><link linkend="gboolean"><type>gboolean</type></link> rotate</parameter>);</programlisting>
<para>Sets whether this job is printed rotated.</para>
<refsect3 id="gtk-print-job-set-rotate.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>job</para></entry>
<entry role="parameter_description"><para>a <link linkend="GtkPrintJob"><type>GtkPrintJob</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>rotate</para></entry>
<entry role="parameter_description"><para>whether to print rotated</para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3></refsect2>
<refsect2 id="gtk-print-job-get-collate" role="function">
<title>gtk_print_job_get_collate&#160;()</title>
<indexterm zone="gtk-print-job-get-collate"><primary>gtk_print_job_get_collate</primary></indexterm>
<programlisting language="C"><link linkend="gboolean"><returnvalue>gboolean</returnvalue></link>
gtk_print_job_get_collate (<parameter><link linkend="GtkPrintJob"><type>GtkPrintJob</type></link> *job</parameter>);</programlisting>
<para>Gets whether this job is printed collated.</para>
<refsect3 id="gtk-print-job-get-collate.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>job</para></entry>
<entry role="parameter_description"><para>a <link linkend="GtkPrintJob"><type>GtkPrintJob</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><refsect3 id="gtk-print-job-get-collate.returns" role="returns">
<title>Returns</title>
<para> whether the job is printed collated</para>
</refsect3></refsect2>
<refsect2 id="gtk-print-job-set-collate" role="function">
<title>gtk_print_job_set_collate&#160;()</title>
<indexterm zone="gtk-print-job-set-collate"><primary>gtk_print_job_set_collate</primary></indexterm>
<programlisting language="C"><link linkend="void"><returnvalue>void</returnvalue></link>
gtk_print_job_set_collate (<parameter><link linkend="GtkPrintJob"><type>GtkPrintJob</type></link> *job</parameter>,
                           <parameter><link linkend="gboolean"><type>gboolean</type></link> collate</parameter>);</programlisting>
<para>Sets whether this job is printed collated.</para>
<refsect3 id="gtk-print-job-set-collate.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>job</para></entry>
<entry role="parameter_description"><para>a <link linkend="GtkPrintJob"><type>GtkPrintJob</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>collate</para></entry>
<entry role="parameter_description"><para>whether the job is printed collated</para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3></refsect2>
<refsect2 id="gtk-print-job-get-reverse" role="function">
<title>gtk_print_job_get_reverse&#160;()</title>
<indexterm zone="gtk-print-job-get-reverse"><primary>gtk_print_job_get_reverse</primary></indexterm>
<programlisting language="C"><link linkend="gboolean"><returnvalue>gboolean</returnvalue></link>
gtk_print_job_get_reverse (<parameter><link linkend="GtkPrintJob"><type>GtkPrintJob</type></link> *job</parameter>);</programlisting>
<para>Gets whether this job is printed reversed.</para>
<refsect3 id="gtk-print-job-get-reverse.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>job</para></entry>
<entry role="parameter_description"><para>a <link linkend="GtkPrintJob"><type>GtkPrintJob</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><refsect3 id="gtk-print-job-get-reverse.returns" role="returns">
<title>Returns</title>
<para> whether the job is printed reversed.</para>
</refsect3></refsect2>
<refsect2 id="gtk-print-job-set-reverse" role="function">
<title>gtk_print_job_set_reverse&#160;()</title>
<indexterm zone="gtk-print-job-set-reverse"><primary>gtk_print_job_set_reverse</primary></indexterm>
<programlisting language="C"><link linkend="void"><returnvalue>void</returnvalue></link>
gtk_print_job_set_reverse (<parameter><link linkend="GtkPrintJob"><type>GtkPrintJob</type></link> *job</parameter>,
                           <parameter><link linkend="gboolean"><type>gboolean</type></link> reverse</parameter>);</programlisting>
<para>Sets whether this job is printed reversed.</para>
<refsect3 id="gtk-print-job-set-reverse.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>job</para></entry>
<entry role="parameter_description"><para>a <link linkend="GtkPrintJob"><type>GtkPrintJob</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>reverse</para></entry>
<entry role="parameter_description"><para>whether the job is printed reversed</para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3></refsect2>

</refsect1>
<refsect1 id="GtkPrintJob.other_details" role="details">
<title role="details.title">Types and Values</title>
<refsect2 id="GtkPrintJob-struct" role="struct">
<title>GtkPrintJob</title>
<indexterm zone="GtkPrintJob-struct"><primary>GtkPrintJob</primary></indexterm>
<programlisting language="C">typedef struct _GtkPrintJob GtkPrintJob;</programlisting>
</refsect2>

</refsect1>
<refsect1 id="GtkPrintJob.property-details" role="property_details">
<title role="property_details.title">Property Details</title>
<refsect2 id="GtkPrintJob--page-setup" role="property"><title>The <literal>“page-setup”</literal> property</title>
<indexterm zone="GtkPrintJob--page-setup"><primary>GtkPrintJob:page-setup</primary></indexterm>
<programlisting>  “page-setup”               <link linkend="GtkPageSetup"><type>GtkPageSetup</type></link>&#160;*</programlisting>
<para>Page Setup.</para><para>Owner: GtkPrintJob</para>
<para>Flags: Read / Write / Construct&#160;Only</para>
</refsect2>
<refsect2 id="GtkPrintJob--printer" role="property"><title>The <literal>“printer”</literal> property</title>
<indexterm zone="GtkPrintJob--printer"><primary>GtkPrintJob:printer</primary></indexterm>
<programlisting>  “printer”                  <link linkend="GtkPrinter"><type>GtkPrinter</type></link>&#160;*</programlisting>
<para>Printer to print the job to.</para><para>Owner: GtkPrintJob</para>
<para>Flags: Read / Write / Construct&#160;Only</para>
</refsect2>
<refsect2 id="GtkPrintJob--settings" role="property"><title>The <literal>“settings”</literal> property</title>
<indexterm zone="GtkPrintJob--settings"><primary>GtkPrintJob:settings</primary></indexterm>
<programlisting>  “settings”                 <link linkend="GtkPrintSettings"><type>GtkPrintSettings</type></link>&#160;*</programlisting>
<para>Printer settings.</para><para>Owner: GtkPrintJob</para>
<para>Flags: Read / Write / Construct&#160;Only</para>
</refsect2>
<refsect2 id="GtkPrintJob--title" role="property"><title>The <literal>“title”</literal> property</title>
<indexterm zone="GtkPrintJob--title"><primary>GtkPrintJob:title</primary></indexterm>
<programlisting>  “title”                    <link linkend="gchar"><type>gchar</type></link>&#160;*</programlisting>
<para>Title of the print job.</para><para>Owner: GtkPrintJob</para>
<para>Flags: Read / Write / Construct&#160;Only</para>
<para>Default value: NULL</para>
</refsect2>
<refsect2 id="GtkPrintJob--track-print-status" role="property"><title>The <literal>“track-print-status”</literal> property</title>
<indexterm zone="GtkPrintJob--track-print-status"><primary>GtkPrintJob:track-print-status</primary></indexterm>
<programlisting>  “track-print-status”       <link linkend="gboolean"><type>gboolean</type></link></programlisting>
<para>TRUE if the print job will continue to emit status-changed signals after the print data has been sent to the printer or print server.</para><para>Owner: GtkPrintJob</para>
<para>Flags: Read / Write</para>
<para>Default value: FALSE</para>
</refsect2>

</refsect1>
<refsect1 id="GtkPrintJob.signal-details" role="signals">
<title role="signals.title">Signal Details</title>
<refsect2 id="GtkPrintJob-status-changed" role="signal"><title>The <literal>“status-changed”</literal> signal</title>
<indexterm zone="GtkPrintJob-status-changed"><primary>GtkPrintJob::status-changed</primary></indexterm>
<programlisting language="C"><link linkend="void"><returnvalue>void</returnvalue></link>
user_function (<link linkend="GtkPrintJob"><type>GtkPrintJob</type></link> *job,
               <link linkend="gpointer"><type>gpointer</type></link>     user_data)</programlisting>
<para>Gets emitted when the status of a job changes. The signal handler
can use <link linkend="gtk-print-job-get-status"><function>gtk_print_job_get_status()</function></link> to obtain the new status.</para>
<refsect3 id="GtkPrintJob-status-changed.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>job</para></entry>
<entry role="parameter_description"><para>the <link linkend="GtkPrintJob"><type>GtkPrintJob</type></link> object on which the signal was emitted</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><simpara>user_data</simpara></entry>
<entry role="parameter_description"><simpara>user data set when the signal handler was connected.</simpara></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><para>Flags: <link linkend="G-SIGNAL-RUN-LAST:CAPS">Run Last</link></para>
</refsect2>
</refsect1>

</refentry>
