<?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-gtkmountoperation">
    <refnamediv>
        <refname>gtk.MountOperation</refname>
        <refpurpose>Functions for working with GIO (new in PyGTK 2.14)</refpurpose>
    </refnamediv>

    <refsect1>
        <title>Synopsis</title>

    <classsynopsis language="python">
        <ooclass><classname>gtk.MountOperation</classname></ooclass>
        <ooclass><classname><link linkend="class-giomountoperation">gio.MountOperation</link></classname></ooclass>
    
    <methodsynopsis language="python">
        <methodname><link linkend="method-gtkmountoperation--get-parent">get_parent</link></methodname>
        <methodparam></methodparam>
    </methodsynopsis>
    <methodsynopsis language="python">
        <methodname><link linkend="method-gtkmountoperation--get-screen">get_screen</link></methodname>
        <methodparam></methodparam>
    </methodsynopsis>
    <methodsynopsis language="python">
        <methodname><link linkend="method-gtkmountoperation--is-showing">is_showing</link></methodname>
        <methodparam></methodparam>
    </methodsynopsis>
    <methodsynopsis language="python">
        <methodname><link linkend="method-gtkmountoperation--set-parent">set_parent</link></methodname>
        <methodparam><parameter role="keyword">parent</parameter></methodparam>
    </methodsynopsis>
    <methodsynopsis language="python">
        <methodname><link linkend="method-gtkmountoperation--set-screen">set_screen</link></methodname>
        <methodparam><parameter role="keyword">screen</parameter></methodparam>
    </methodsynopsis>

    </classsynopsis>

    </refsect1>

    <refsect1>
        <title>Ancestry</title>

<synopsis>+-- <link linkend="class-gobject">gobject.GObject</link>
  +-- <link linkend="class-giomountoperation">gio.MountOperation</link>
    +-- <link linkend="class-gtkmountoperation">gtk.MountOperation</link>
</synopsis>

    </refsect1>

  <refsect1 id="properties-gtkmountoperation">
    <title>gtk.MountOperation 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="3.5in"/>
	  <tbody>

	    <row valign="top">
	      <entry>"is-showing"</entry>
	      <entry>Read</entry>
	      <entry>Are we showing a dialog. Default value: <literal>False</literal>.</entry>
	  </row>

	    <row valign="top">
	      <entry>"parent"</entry>
	      <entry>Read/Write</entry>
          <entry>The parent window.</entry>
	  </row>

	    <row valign="top">
	      <entry>"screen"</entry>
	      <entry>Read/Write</entry>
          <entry>The screen where this window will be displayed.</entry>
	  </row>

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

  </refsect1>

    <refsect1>
        <title>Description</title>
            <para>
                The functions and objects described here make working with GTK+ and GIO more convenient.
                <link linkend="class-gtkmountoperation"><classname>gtk.MountOperation</classname></link>
                is needed when mounting volumes and
                <methodname><link linkend="function-gtk--show-uri">gtk.show_uri</link></methodname>()
                is a convenient way to launch applications for URIs. Another object that is worth
                mentioning in this context is 
                <link linkend="class-gdkapplaunchcontext"><classname>gtk.gdk.AppLaunchContext</classname></link>,
                which provides visual feedback when lauching applications.
            </para>
    </refsect1>
    
    <refsect1 id="constructor-gtkmountoperation">
    <title>Constructor</title>

    <programlisting><constructorsynopsis language="python">
	<methodname>gtk.MountOperation</methodname>
	<methodparam><parameter role="keyword">parent</parameter><initializer>None</initializer></methodparam>
      </constructorsynopsis></programlisting>

    <variablelist>
      <varlistentry>
	<term><parameter role="keyword">parent</parameter>&nbsp;:</term>
	<listitem><simpara>transient parent of the window, or
        <literal>None</literal>.</simpara></listitem>
      </varlistentry>
      <varlistentry>
	<term><emphasis>Returns</emphasis>&nbsp;:</term>
	<listitem><simpara>a new
        <link linkend="class-gtkmountoperation"><classname>gtk.MountOperation</classname></link>.
        </simpara></listitem>
      </varlistentry>
    </variablelist>

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

    <para>
        Creates a new <link linkend="class-gtkmountoperation"><classname>gtk.MountOperation</classname></link>.
    </para>

  </refsect1>

    <refsect1>
        <title>Methods</title>

        <refsect2 id="method-gtkmountoperation--get-parent">
            <title>gtk.MountOperation.get_parent</title>

            <programlisting><methodsynopsis language="python">
                <methodname>get_parent</methodname>
                <methodparam></methodparam>
            </methodsynopsis></programlisting>
            
            <variablelist>
                <varlistentry>
                    <term><emphasis>Returns</emphasis>&nbsp;:</term>
                    <listitem><simpara>a new
                    <link linkend="class-gtkmountoperation"><classname>gtk.MountOperation</classname></link>.
                    </simpara></listitem>
                </varlistentry>
            </variablelist>

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

            <para>
                The <methodname>get_parent</methodname>() method gets the transient
                parent used by the
                <link linkend="class-gtkmountoperation"><classname>gtk.MountOperation</classname></link>.
            </para>
        </refsect2>

        <refsect2 id="method-gtkmountoperation--get-screen">
            <title>gtk.MountOperation.get_screen</title>

            <programlisting><methodsynopsis language="python">
                <methodname>get_screen</methodname>
                <methodparam></methodparam>
            </methodsynopsis></programlisting>
            
            <variablelist>
                <varlistentry>
                    <term><emphasis>Returns</emphasis>&nbsp;:</term>
                    <listitem><simpara>the screen on which windows of op are shown.
                    </simpara></listitem>
                </varlistentry>
            </variablelist>

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

            <para>
                The <methodname>get_screen</methodname>() method gets the screen
                on which windows of the
                <link linkend="class-gtkmountoperation"><classname>gtk.MountOperation</classname></link>
                will be shown.
            </para>
        </refsect2>

        <refsect2 id="method-gtkmountoperation--is-showing">
            <title>gtk.MountOperation.is_showing</title>

            <programlisting><methodsynopsis language="python">
                <methodname>is_showing</methodname>
                <methodparam></methodparam>
            </methodsynopsis></programlisting>
            
            <variablelist>
                <varlistentry>
                    <term><emphasis>Returns</emphasis>&nbsp;:</term>
                    <listitem><simpara><literal>True</literal> if op is currently displaying a window.
                    </simpara></listitem>
                </varlistentry>
            </variablelist>

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

            <para>
                The <methodname>is_showing</methodname>() method returns whetherthe
                <link linkend="class-gtkmountoperation"><classname>gtk.MountOperation</classname></link>
                is currently displaying a window.
            </para>
        </refsect2>

        <refsect2 id="method-gtkmountoperation--set-parent">
            <title>gtk.MountOperation.set_parent</title>

            <programlisting><methodsynopsis language="python">
                <methodname>set_parent</methodname>
                <methodparam><parameter>parent</parameter></methodparam>
            </methodsynopsis></programlisting>
            
            <variablelist>
                <varlistentry>
                    <term><parameter role="keyword">parent</parameter>&nbsp;:</term>
                        <listitem><simpara>transient parent of the window,
                        or <literal>None</literal>.</simpara></listitem>
                </varlistentry>
            </variablelist>

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

            <para>
                The <methodname>set_parent</methodname>() method sets the
                transient parent for windows shown by the
                <link linkend="class-gtkmountoperation"><classname>gtk.MountOperation</classname></link>.
            </para>
        </refsect2>

        <refsect2 id="method-gtkmountoperation--set-screen">
            <title>gtk.MountOperation.set_screen</title>

            <programlisting><methodsynopsis language="python">
                <methodname>set_screen</methodname>
                <methodparam><parameter>screen</parameter></methodparam>
            </methodsynopsis></programlisting>
            
            <variablelist>
                <varlistentry>
                    <term><parameter role="keyword">screen</parameter>&nbsp;:</term>
                        <listitem><simpara>a
                        <link linkend="class-gdkscreen"><classname>gtk.gdk.Screen</classname></link>.
                        </simpara></listitem>
                </varlistentry>
            </variablelist>

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

            <para>
                The <methodname>set_screen</methodname>() method gets the screen
                on which windows of the
                <link linkend="class-gtkmountoperation"><classname>gtk.MountOperation</classname></link>
                will be shown.
            </para>
        </refsect2>
    </refsect1>
</refentry>
