<?xml version="1.0" standalone="no"?>
<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.1.2//EN"
    "http://www.oasis-open.org/docbook/xml/4.1.2/docbookx.dtd">

<refentry id="class-gtkprinter">

  <refnamediv>
    <refname>gtkunixprint.Printer</refname>
      <refpurpose>an object representing a print in Unix (new in PyGTK
      2.10)</refpurpose>
  </refnamediv>

  <refsect1>
    <title>Synopsis</title>

    <classsynopsis language="python">
      <ooclass><classname>gtkunixprint.Printer</classname></ooclass>
      <ooclass><classname><link linkend="class-gobject">gobject.GObject</link></classname></ooclass>

<!-- NOT IMPLEMENTED
      <constructorsynopsis language="python">
        <methodname><link linkend="constructor-gtkprinter">gtkunixprint.Printer</link></methodname>
        <methodparam><parameter role="keyword">name</parameter></methodparam>
        <methodparam><parameter role="keyword">backend</parameter></methodparam>
        <methodparam><parameter role="keyword">is_virtual</parameter></methodparam>
      </constructorsynopsis>
      <methodsynopsis language="python">
        <methodname><link linkend="method-gtkprinter- -get-backend">get_backend</link></methodname>
        <methodparam></methodparam>
      </methodsynopsis>
END NOT IMPLEMENTED -->

      <methodsynopsis language="python">
        <methodname><link linkend="method-gtkprinter--get-name">get_name</link></methodname>
        <methodparam></methodparam>
      </methodsynopsis>
      <methodsynopsis language="python">
        <methodname><link linkend="method-gtkprinter--get-state-message">get_state_message</link></methodname>
        <methodparam></methodparam>
      </methodsynopsis>
      <methodsynopsis language="python">
        <methodname><link linkend="method-gtkprinter--get-capabilities">get_capabilities</link></methodname>
        <methodparam></methodparam>
      </methodsynopsis>
      <methodsynopsis language="python">
        <methodname><link linkend="method-gtkprinter--get-description">get_description</link></methodname>
        <methodparam></methodparam>
      </methodsynopsis>
      <methodsynopsis language="python">
        <methodname><link linkend="method-gtkprinter--get-location">get_location</link></methodname>
        <methodparam></methodparam>
      </methodsynopsis>
      <methodsynopsis language="python">
        <methodname><link linkend="method-gtkprinter--get-icon-name">get_icon_name</link></methodname>
        <methodparam></methodparam>
      </methodsynopsis>
      <methodsynopsis language="python">
        <methodname><link linkend="method-gtkprinter--get-job-count">get_job_count</link></methodname>
        <methodparam></methodparam>
      </methodsynopsis>
      <methodsynopsis language="python">
        <methodname><link linkend="method-gtkprinter--has-details">has_details</link></methodname>
        <methodparam></methodparam>
      </methodsynopsis>
      <methodsynopsis language="python">
        <methodname><link linkend="method-gtkprinter--request-details">request_details</link></methodname>
        <methodparam></methodparam>
      </methodsynopsis>
      <methodsynopsis language="python">
        <methodname><link linkend="method-gtkprinter--is-accepting-jobs">is_accepting_jobs</link></methodname>
        <methodparam></methodparam>
      </methodsynopsis>
      <methodsynopsis language="python">
        <methodname><link linkend="method-gtkprinter--is-active">is_active</link></methodname>
        <methodparam></methodparam>
      </methodsynopsis>
      <methodsynopsis language="python">
        <methodname><link linkend="method-gtkprinter--is-default">is_default</link></methodname>
        <methodparam></methodparam>
      </methodsynopsis>
      <methodsynopsis language="python">
        <methodname><link linkend="method-gtkprinter--is-paused">is_paused</link></methodname>
        <methodparam></methodparam>
      </methodsynopsis>
      <methodsynopsis language="python">
        <methodname><link linkend="method-gtkprinter--is-virtual">is_virtual</link></methodname>
        <methodparam></methodparam>
      </methodsynopsis>
      <methodsynopsis language="python">
        <methodname><link linkend="method-gtkprinter--compare">compare</link></methodname>
        <methodparam><parameter role="keyword">b</parameter></methodparam>
      </methodsynopsis>
      <methodsynopsis language="python">
        <methodname><link linkend="method-gtkprinter--accepts-pdf">accepts_pdf</link></methodname>
        <methodparam></methodparam>
      </methodsynopsis>
      <methodsynopsis language="python">
        <methodname><link linkend="method-gtkprinter--accepts-ps">accepts_ps</link></methodname>
        <methodparam></methodparam>
      </methodsynopsis>
</classsynopsis>

  </refsect1>

  <refsect1>
    <title>Ancestry</title>

<synopsis>+-- <link linkend="class-gobject">gobject.GObject</link>
  +-- <link linkend="class-gtkprinter">gtkunixprint.Printer</link>
</synopsis>

  </refsect1>

  <refsect1 id="properties-gtkprinter">
    <title>gtkunixprint.Printer Properties</title>

    <blockquote role="properties">
      <informaltable pgwide="1" frame="none">
	<tgroup cols="3">
	  <colspec column="1" colwidth="1in"/>
	  <colspec column="2" colwidth="1in"/>
	  <colspec column="3" colwidth="4in"/>
	  <tbody>

            <row valign="top">
              <entry>"accepting-jobs"</entry>
              <entry>Read</entry>
              <entry>This property is <literal>True</literal> if the printer
              is accepting jobs. Default value: <literal>True</literal>.
              Available in GTK+ 2.14.</entry>
            </row>

            <row valign="top">
              <entry>"accepts-ps"</entry>
              <entry>Read-Write-Construct Only</entry>
              <entry>if <literal>True</literal> this printer can accept
              PostScript. Available in GTK+ 2.10.</entry>
            </row>

            <row valign="top">
              <entry>"accepts-ps"</entry>
              <entry>Read-Write-Construct Only</entry>
              <entry>if <literal>True</literal> this printer can accept
              PostScript. Available in GTK+ 2.10.</entry>
            </row>

	    <row valign="top">
	      <entry>"backend"</entry>
	      <entry>Read-Write-Construct Only</entry>
	      <entry>The backend for the printer. Not currently useful in
	      PyGTK. Available in GTK+ 2.10.</entry>
	    </row>

	    <row valign="top">
	      <entry>"icon-name"</entry>
	      <entry>Read</entry>
	      <entry>The icon name to use for the printer. Default value:
	      <literal>None</literal>. Available in GTK+ 2.10.</entry>
	    </row>

	    <row valign="top">
	      <entry>"is-virtual"</entry>
	      <entry>Read-Write</entry>
	      <entry>if <literal>False</literal> this represents a real
	      hardware printer.  Default value:
	      <literal>False</literal>. Available in GTK+ 2.10.</entry>
	    </row>

	    <row valign="top">
	      <entry>"job-count"</entry>
	      <entry>Read</entry>
	      <entry>The number of jobs queued in the printer.  Allowed
	      values: >= 0. Default value: 0. Available in GTK+
	      2.10.</entry>
	    </row>

	    <row valign="top">
	      <entry>"location"</entry>
	      <entry>Read</entry>
	      <entry>The location of the printer. Default value:
	      <literal>None</literal>. Available in GTK+ 2.10.</entry>
	    </row>

	    <row valign="top">
	      <entry>"name"</entry>
	      <entry>Read-Write-Construct Only</entry>
	      <entry>The name of the printer.  Default value:
	      <literal>None</literal>. Available in GTK+ 2.10.</entry>
	    </row>

	    <row valign="top">
	      <entry>"paused"</entry>
	      <entry>Read</entry>
	      <entry>This property is <literal>True</literal> if this printer is paused. A paused
              printer still accepts jobs, but it does not print them.
              Default value: <literal>False</literal>
              Available in GTK+ 2.14.</entry>
	    </row>

	    <row valign="top">
	      <entry>"state-message"</entry>
	      <entry>Read</entry>
	      <entry>A string giving the current state of the printer.
	      Default value: <literal>None</literal>. Available in GTK+
	      2.10.</entry>
	    </row>

	  </tbody>
	</tgroup>
      </informaltable>
    </blockquote>

  </refsect1>

  <refsect1 id="signal-prototypes-gtkprinter">
    <title>gtkunixprint.Printer Signal Prototypes</title>

    <para><link linkend="signal-prototypes-gobject">gobject.GObject Signal Prototypes</link></para>

    <variablelist>
      <varlistentry>
        <term>"<link linkend="signal-gtkprinter--details-acquired">details-acquired</link>"</term>
        <listitem>
          <methodsynopsis language="python"><methodname>callback</methodname>
            <methodparam><parameter>printer</parameter></methodparam>
            <methodparam><parameter>success</parameter></methodparam>
            <methodparam><parameter>user_param1</parameter></methodparam>
            <methodparam><parameter>...</parameter></methodparam>
          </methodsynopsis>
        </listitem>
      </varlistentry>
    </variablelist>

  </refsect1>

  <refsect1>
    <title>Description</title>

    <note>
      <para>This class is available in PyGTK 2.10 and above.</para>
    </note>

    <para>A <link
    linkend="class-gtkprinter"><classname>gtkunixprint.Printer</classname></link>
    object represents a printer. You only need to deal directly with
    printers if you use the non-portable <link
    linkend="class-gtkprintunixdialog"><classname>gtkunixprint.PrintUnixDialog</classname></link>
    API.</para>

    <para>A <link
    linkend="class-gtkprinter"><classname>gtkunixprint.Printer</classname></link>
    allows you to get status information about the printer, such as its
    description, its location, the number of queued jobs, etc. Most
    importantly, a <link
    linkend="class-gtkprinter"><classname>gtkunixprint.Printer</classname></link>
    object can be used to create a <link
    linkend="class-gtkprintjob"><classname>gtkunixprint.PrintJob</classname></link>
    object, that lets you print to the printer.</para>

  </refsect1>

<!-- NOT IMPLEMENTED
  <refsect1>
    <title>Constructor</title>

    <refsect2 id="constructor-gtkprinter">
      <title>gtkunixprint.Printer</title>

      <programlisting><constructorsynopsis language="python">
        <methodname>gtkunixprint.Printer</methodname>
        <methodparam><parameter role="keyword">name</parameter></methodparam>
        <methodparam><parameter role="keyword">backend</parameter></methodparam>
        <methodparam><parameter role="keyword">is_virtual</parameter></methodparam>
      </constructorsynopsis></programlisting>

      <variablelist>
        <varlistentry>
          <term><parameter role="keyword">name</parameter>&nbsp;:</term>
          <listitem><simpara>the name of the printer</simpara></listitem>
        </varlistentry>
        <varlistentry>
          <term><parameter role="keyword">backend</parameter>&nbsp;:</term>
          <listitem><simpara>a <literal>GtkPrintBackend</literal></simpara></listitem>
        </varlistentry>
        <varlistentry>
          <term><parameter role="keyword">is_virtual</parameter>&nbsp;:</term>
          <listitem><simpara></simpara></listitem>
        </varlistentry>
        <varlistentry>
          <term><emphasis>Returns</emphasis>&nbsp;:</term>
          <listitem><simpara>a new <link linkend="class-gtkprinter"><classname>gtkunixprint.Printer</classname></link></simpara></listitem>
        </varlistentry>
      </variablelist>

      <note>
        <para>This constructor is available in PyGTK 2.10 and above.</para>
      </note>

      <para>Creates a new <link linkend="class-gtkprinter"><classname>gtkunixprint.Printer</classname></link>.</para>

    </refsect2>

  </refsect1>
END NOT IMPLEMENTED -->

  <refsect1>
    <title>Methods</title>

<!-- NOT IMPLEMENTED
    <refsect2 id="method-gtkprinter- -get-backend">
      <title>gtkunixprint.Printer.get_backend</title>

      <programlisting><methodsynopsis language="python">
        <methodname>get_backend</methodname>
        <methodparam></methodparam>
      </methodsynopsis></programlisting>

      <variablelist>
        <varlistentry>
          <term><emphasis>Returns</emphasis>&nbsp;:</term>
          <listitem><simpara>the backend of <parameter>printer</parameter></simpara></listitem>
        </varlistentry>
      </variablelist>

      <note>
        <para>This method is available in PyGTK 2.10 and above.</para>
      </note>

      <para>The <methodname>get_backend</methodname>() method returns the backend of the printer.</para>

    </refsect2>
END NOT IMPLEMENTED -->

    <refsect2 id="method-gtkprinter--get-name">
      <title>gtkunixprint.Printer.get_name</title>

      <programlisting><methodsynopsis language="python">
        <methodname>get_name</methodname>
        <methodparam></methodparam>
      </methodsynopsis></programlisting>

      <variablelist>
        <varlistentry>
          <term><emphasis>Returns</emphasis>&nbsp;:</term>
          <listitem><simpara>the name of the printer</simpara></listitem>
        </varlistentry>
      </variablelist>

      <note>
        <para>This method is available in PyGTK 2.10 and above.</para>
      </note>

      <para>The <methodname>get_name</methodname>() method returns the name
      of the printer.</para>

    </refsect2>

    <refsect2 id="method-gtkprinter--get-state-message">
      <title>gtkunixprint.Printer.get_state_message</title>

      <programlisting><methodsynopsis language="python">
        <methodname>get_state_message</methodname>
        <methodparam></methodparam>
      </methodsynopsis></programlisting>

      <variablelist>
        <varlistentry>
          <term><emphasis>Returns</emphasis>&nbsp;:</term>
          <listitem><simpara>the state message of the
          printer</simpara></listitem>
        </varlistentry>
      </variablelist>

      <note>
        <para>This method is available in PyGTK 2.10 and above.</para>
      </note>

      <para>The <methodname>get_state_message</methodname>() method returns
      the state message describing the current state of the printer.</para>

    </refsect2>

    <refsect2 id="method-gtkprinter--get-description">
      <title>gtkunixprint.Printer.get_description</title>

      <programlisting><methodsynopsis language="python">
        <methodname>get_description</methodname>
        <methodparam></methodparam>
      </methodsynopsis></programlisting>

      <variablelist>
        <varlistentry>
          <term><emphasis>Returns</emphasis>&nbsp;:</term>
          <listitem><simpara>the description of the
          printer</simpara></listitem>
        </varlistentry>
      </variablelist>

      <note>
        <para>This method is available in PyGTK 2.10 and above.</para>
      </note>

      <para>The <methodname>get_description</methodname>() method returns
      the description of the printer.</para>

    </refsect2>
    
    <refsect2 id="method-gtkprinter--get-capabilities">
      <title>gtkunixprint.Printer.get_capabilities</title>

      <programlisting><methodsynopsis language="python">
        <methodname>get_capabilities</methodname>
        <methodparam></methodparam>
      </methodsynopsis></programlisting>

      <variablelist>
        <varlistentry>
          <term><emphasis>Returns</emphasis>&nbsp;:</term>
          <listitem><simpara>the printer's capabilities.</simpara></listitem>
        </varlistentry>
      </variablelist>

      <note>
        <para>This method is available in PyGTK 2.12 and above.</para>
      </note>

      <para>The <methodname>get_capabilities</methodname>() method returns
      the printer's capabilities.</para>
      
      <para>This is useful when you're using GtkPrintUnixDialog's
      manual-capabilities setting and need to know which settings the
      printer can handle and which you must handle yourself.</para>
      
      <para>This will return 0 unless the printer's details are available,
      see <link linkend="method-gtkprinter--has-details">gtkunixprint.Printer.has_details</link>()
      and <link linkend="method-gtkprinter--request-details">gtkunixprint.Printer.request_details</link>().
      </para>

    </refsect2>

    <refsect2 id="method-gtkprinter--get-location">
      <title>gtkunixprint.Printer.get_location</title>

      <programlisting><methodsynopsis language="python">
        <methodname>get_location</methodname>
        <methodparam></methodparam>
      </methodsynopsis></programlisting>

      <variablelist>
        <varlistentry>
          <term><emphasis>Returns</emphasis>&nbsp;:</term>
          <listitem><simpara>the location of  the printer</simpara></listitem>
        </varlistentry>
      </variablelist>

      <note>
        <para>This method is available in PyGTK 2.10 and above.</para>
      </note>

      <para>The <methodname>get_location</methodname>() method returns a
      description of the location of the printer.</para>

    </refsect2>

    <refsect2 id="method-gtkprinter--get-icon-name">
      <title>gtkunixprint.Printer.get_icon_name</title>

      <programlisting><methodsynopsis language="python">
        <methodname>get_icon_name</methodname>
        <methodparam></methodparam>
      </methodsynopsis></programlisting>

      <variablelist>
        <varlistentry>
          <term><emphasis>Returns</emphasis>&nbsp;:</term>
          <listitem><simpara>the icon name for  the printer</simpara></listitem>
        </varlistentry>
      </variablelist>

      <note>
        <para>This method is available in PyGTK 2.10 and above.</para>
      </note>

      <para>The <methodname>get_icon_name</methodname>() method returns the
      name of the icon to use for the printer.</para>

    </refsect2>

    <refsect2 id="method-gtkprinter--get-job-count">
      <title>gtkunixprint.Printer.get_job_count</title>

      <programlisting><methodsynopsis language="python">
        <methodname>get_job_count</methodname>
        <methodparam></methodparam>
      </methodsynopsis></programlisting>

      <variablelist>
        <varlistentry>
          <term><emphasis>Returns</emphasis>&nbsp;:</term>
          <listitem><simpara>the number of jobs on  the printer</simpara></listitem>
        </varlistentry>
      </variablelist>

      <note>
        <para>This method is available in PyGTK 2.10 and above.</para>
      </note>

      <para>The <methodname>get_job_count</methodname>() method returns the
      number of jobs currently queued on the printer.</para>

    </refsect2>
    
    <refsect2 id="method-gtkprinter--has-details">
      <title>gtkunixprint.Printer.has_details</title>

      <programlisting><methodsynopsis language="python">
        <methodname>has_details</methodname>
        <methodparam></methodparam>
      </methodsynopsis></programlisting>

      <variablelist>
        <varlistentry>
          <term><emphasis>Returns</emphasis>&nbsp;:</term>
          <listitem><simpara><literal>True</literal> if printer details
          are available</simpara></listitem>
        </varlistentry>
      </variablelist>

      <note>
        <para>This method is available in PyGTK 2.12 and above.</para>
      </note>

      <para>The <methodname>has_details</methodname>() method returns
      whether the printer details are available.</para>

    </refsect2>
    
    <refsect2 id="method-gtkprinter--request-details">
      <title>gtkunixprint.Printer.request_details</title>

      <programlisting><methodsynopsis language="python">
        <methodname>request_details</methodname>
        <methodparam></methodparam>
      </methodsynopsis></programlisting>

      <variablelist>
      </variablelist>

      <note>
        <para>This method is available in PyGTK 2.12 and above.</para>
      </note>

      <para>The <methodname>request_details</methodname>() method requests
      the printer details. When the details are available,
      the GtkPrinter::details-acquired signal will be emitted on printer.</para>

    </refsect2>

    <refsect2 id="method-gtkprinter--is-accepting-jobs">
      <title>gtkunixprint.Printer.is_accepting_jobs</title>

      <programlisting><methodsynopsis language="python">
        <methodname>is_accepting_jobs</methodname>
        <methodparam></methodparam>
      </methodsynopsis></programlisting>

      <variablelist>
        <varlistentry>
          <term><emphasis>Returns</emphasis>&nbsp;:</term>
          <listitem><simpara><literal>True</literal> if printer is accepting jobs.</simpara></listitem>
        </varlistentry>
      </variablelist>

      <note>
        <para>This method is available in PyGTK 2.14 and above.</para>
      </note>

      <para>The <methodname>is_accepting_jobs</methodname>() method returns
      whether the printer is accepting jobs</para>

    </refsect2>

    <refsect2 id="method-gtkprinter--is-active">
      <title>gtkunixprint.Printer.is_active</title>

      <programlisting><methodsynopsis language="python">
        <methodname>is_active</methodname>
        <methodparam></methodparam>
      </methodsynopsis></programlisting>

      <variablelist>
        <varlistentry>
          <term><emphasis>Returns</emphasis>&nbsp;:</term>
          <listitem><simpara><literal>True</literal> if  the printer is active</simpara></listitem>
        </varlistentry>
      </variablelist>

      <note>
        <para>This method is available in PyGTK 2.10 and above.</para>
      </note>

      <para>The <methodname>is_active</methodname>() method returns
      <literal>True</literal> if the printer is currently active (i.e.
      accepts new jobs).</para>

    </refsect2>

    <refsect2 id="method-gtkprinter--is-paused">
      <title>gtkunixprint.Printer.is_paused</title>

      <programlisting><methodsynopsis language="python">
        <methodname>is_paused</methodname>
        <methodparam></methodparam>
      </methodsynopsis></programlisting>

      <variablelist>
        <varlistentry>
          <term><emphasis>Returns</emphasis>&nbsp;:</term>
          <listitem><simpara><literal>True</literal> if the printer is paused.</simpara></listitem>
        </varlistentry>
      </variablelist>

      <note>
        <para>This method is available in PyGTK 2.14 and above.</para>
      </note>

      <para>The <methodname>is_paused</methodname>() method returns
      whether the printer is currently paused. A paused printer still accepts
      jobs, but it is not printing them.</para>

    </refsect2>

    <refsect2 id="method-gtkprinter--is-virtual">
      <title>gtkunixprint.Printer.is_virtual</title>

      <programlisting><methodsynopsis language="python">
        <methodname>is_virtual</methodname>
        <methodparam></methodparam>
      </methodsynopsis></programlisting>

      <variablelist>
        <varlistentry>
          <term><emphasis>Returns</emphasis>&nbsp;:</term>
          <listitem><simpara><literal>True</literal> if the printer is
          virtual</simpara></listitem>
        </varlistentry>
      </variablelist>

      <note>
        <para>This method is available in PyGTK 2.10 and above.</para>
      </note>

      <para>The <methodname>is_virtual</methodname>() method returns
      <literal>True</literal> if the printer is virtual (i.e. does not
      represent actual printer hardware, but something like a CUPS
      class).</para>

    </refsect2>

    <refsect2 id="method-gtkprinter--is-default">
      <title>gtkunixprint.Printer.is_default</title>

      <programlisting><methodsynopsis language="python">
        <methodname>is_default</methodname>
        <methodparam></methodparam>
      </methodsynopsis></programlisting>

      <variablelist>
        <varlistentry>
          <term><emphasis>Returns</emphasis>&nbsp;:</term>
          <listitem><simpara><literal>True</literal> if  the printer is the default</simpara></listitem>
        </varlistentry>
      </variablelist>

      <note>
        <para>This method is available in PyGTK 2.10 and above.</para>
      </note>

      <para>The <methodname>is_default</methodname>() method returns
      <literal>True</literal> if the printer is the default printer.</para>

    </refsect2>

    <refsect2 id="method-gtkprinter--compare">
      <title>gtkunixprint.Printer.compare</title>

      <programlisting><methodsynopsis language="python">
        <methodname>compare</methodname>
        <methodparam><parameter role="keyword">b</parameter></methodparam>
      </methodsynopsis></programlisting>

      <variablelist>
        <varlistentry>
          <term><parameter role="keyword">b</parameter>&nbsp;:</term>
          <listitem><simpara>a <link
          linkend="class-gtkprinter"><classname>gtkunixprint.Printer</classname></link></simpara></listitem>
        </varlistentry>
        <varlistentry>
          <term><emphasis>Returns</emphasis>&nbsp;:</term>
          <listitem><simpara>an integer indicating the result of the
          comparison of the <link
          linkend="class-gtkprinter"><classname>gtkunixprint.Printer</classname></link>
          names.</simpara></listitem>
        </varlistentry>
      </variablelist>

      <note>
        <para>This method is available in PyGTK 2.10 and above.</para>
      </note>

      <para>The compare() method compares the name of the printer to the
      name of the <link
      linkend="class-gtkprinter"><classname>gtkunixprint.Printer</classname></link>
      specified by <parameter>b</parameter> and returns:</para>

      <itemizedlist>
        <listitem>
          <para>a negative integer if the name of the printer is less than
          the name of <parameter>b</parameter>.</para>
        </listitem>
        <listitem>
          <para>a negative integer if the name of the printer is the same as
          the name of <parameter>b</parameter>.</para>
        </listitem>
        <listitem>
          <para>a positive integer if the name of the printer is greater
          than the name of <parameter>b</parameter>.</para>
        </listitem>
      </itemizedlist>

    </refsect2>

    <refsect2 id="method-gtkprinter--accepts-pdf">
      <title>gtkunixprint.Printer.accepts_pdf</title>

      <programlisting><methodsynopsis language="python">
        <methodname>accepts_pdf</methodname>
        <methodparam></methodparam>
      </methodsynopsis></programlisting>

      <variablelist>
        <varlistentry>
          <term><emphasis>Returns</emphasis>&nbsp;:</term>
          <listitem><simpara><literal>True</literal> if the printer accepts
          PDF</simpara></listitem>
        </varlistentry>
      </variablelist>
                                                                                
      <note>
        <para>This method is available in PyGTK 2.10 and above.</para>
      </note>

      <para>Returns whether the printer accepts input in PDF format.</para>

    </refsect2>

    <refsect2 id="method-gtkprinter--accepts-ps">
      <title>gtkunixprint.Printer.accepts_ps</title>

      <programlisting><methodsynopsis language="python">
        <methodname>accepts_ps</methodname>
        <methodparam></methodparam>
      </methodsynopsis></programlisting>

      <variablelist>
        <varlistentry>
          <term><emphasis>Returns</emphasis>&nbsp;:</term>
          <listitem><simpara><literal>True</literal> if the printer accepts
          PostScript</simpara></listitem>
        </varlistentry>
      </variablelist>

      <note>
        <para>This method is available in PyGTK 2.10 and above.</para>
      </note>

      <para>Returns whether the printer accepts input in PostScript
      format.</para>

    </refsect2>

  </refsect1>

  <refsect1>
    <title>Signals</title>

    <refsect2 id="signal-gtkprinter--details-acquired">
      <title>The "details-acquired" Signal</title>

      <programlisting><methodsynopsis language="python">
	  <methodname>callback</methodname>
	  <methodparam><parameter>printer</parameter></methodparam>
	  <methodparam><parameter>success</parameter></methodparam>
	  <methodparam><parameter>user_param1</parameter></methodparam>
	  <methodparam><parameter>...</parameter></methodparam>
	</methodsynopsis></programlisting>

      <variablelist>
	<varlistentry>
	  <term><parameter>printer</parameter>&nbsp;:</term>
	  <listitem><simpara>the printer that received the
signal</simpara></listitem>
	</varlistentry>
	<varlistentry>
	  <term><parameter>success</parameter>&nbsp;:</term>
	  <listitem><simpara><literal>True</literal> if the details were
	  successfully acquired</simpara></listitem>
	</varlistentry>
	<varlistentry>
	  <term><parameter>user_param1</parameter>&nbsp;:</term>
          <listitem><simpara>the first user parameter (if any) specified
with the <link
linkend="method-gobject--connect"><methodname>connect</methodname>()</link>
method</simpara></listitem>
	</varlistentry>
	<varlistentry>
	  <term><parameter>...</parameter>&nbsp;:</term>
	  <listitem><simpara>additional user parameters (if
any)</simpara></listitem>
	</varlistentry>
      </variablelist>

      <note>
        <para>This signal is available in GTK+ 2.10 and above.</para>
      </note>

      <para>The "details-acquired" signal is emitted in response to a
      request for detailed information about a printer from the print
      backend. The success parameter indicates if the information was
      actually obtained.</para>

    </refsect2>

  </refsect1>

</refentry>
