pygtk r3116 - trunk/docs/reference

[gianmt svn gnome org]

Author: gianmt
Date: Mon Mar  9 20:48:10 2009
New Revision: 3116
URL: http://svn.gnome.org/viewvc/pygtk?rev=3116&view=rev

Log:
2009-03-09  Gian Mario Tagliaretti  <gianmt gnome org>

	Bug 574640 â gtk.FileChooserButton "file-set" signal is not documented

	* pygtk-gtkfilechooserbutton.xml: Add "file-set" signal.



Modified:
   trunk/docs/reference/ChangeLog
   trunk/docs/reference/pygtk-gtkfilechooserbutton.xml

Modified: trunk/docs/reference/pygtk-gtkfilechooserbutton.xml
==============================================================================
--- trunk/docs/reference/pygtk-gtkfilechooserbutton.xml	(original)
+++ trunk/docs/reference/pygtk-gtkfilechooserbutton.xml	Mon Mar  9 20:48:10 2009
@@ -160,6 +160,22 @@
     <para><link linkend="signal-prototypes-gtkwidget">gtk.Widget Signal Prototypes</link></para>
     <para><link linkend="signal-prototypes-gtkcontainer">gtk.Container Signal Prototypes</link></para>
     <para><link linkend="signal-prototypes-gtkfilechooser">gtk.FileChooser Signal Prototypes</link></para>
+    
+    <variablelist>
+      <varlistentry>
+        <term>"<link linkend="signal-gtkfilechooserbutton--file-set">file-set</link>"</term>
+        <listitem>
+          <methodsynopsis language="python"><methodname>callback</methodname>
+            <methodparam><parameter>filechooserbutton</parameter>
+            </methodparam>
+            <methodparam><parameter>user_param1</parameter>
+            </methodparam>
+            <methodparam><parameter>...</parameter>
+            </methodparam>
+          </methodsynopsis>
+        </listitem>
+      </varlistentry>
+    </variablelist>
   </refsect1>
 
   <refsect1>
@@ -452,6 +468,48 @@
 
     </refsect2>
 
+  </refsect1><refsect1>
+    <title>Signals</title>
+
+    <refsect2 id="signal-gtkfilechooserbutton--file-set">
+      <title>The "file-set" gtk.FileChooserButton Signal</title>
+
+      <programlisting><methodsynopsis language="python">
+	  <methodname>callback</methodname>
+	  <methodparam><parameter>filechooserbutton</parameter></methodparam>
+	  <methodparam><parameter>user_param1</parameter></methodparam>
+	  <methodparam><parameter>...</parameter></methodparam>
+	</methodsynopsis></programlisting>
+
+      <variablelist>
+	<varlistentry>
+	  <term><parameter>filechooserbutton</parameter>&nbsp;:</term>
+	  <listitem><simpara>the filechooserbutton that received the signal</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.12 and above.</para>
+      </note>
+
+      <para>
+	  The "file-set" signal is emitted when the user selects a file. 
+      </para>
+      <para>
+	  Note that this signal is only emitted when the user changes the file.
+      </para>
+
+    </refsect2>
   </refsect1>
 
 </refentry>