pygtk r3052 - trunk/docs/reference



Author: gianmt
Date: Sun Nov 30 23:20:21 2008
New Revision: 3052
URL: http://svn.gnome.org/viewvc/pygtk?rev=3052&view=rev

Log:
Update docs to 2.14

Modified:
   trunk/docs/reference/ChangeLog
   trunk/docs/reference/pygtk-gtkprogressbar.xml
   trunk/docs/reference/pygtk-gtkrange.xml
   trunk/docs/reference/pygtk-gtkscalebutton.xml
   trunk/docs/reference/pygtk-gtksettings.xml
   trunk/docs/reference/pygtk-gtkstatusicon.xml

Modified: trunk/docs/reference/pygtk-gtkprogressbar.xml
==============================================================================
--- trunk/docs/reference/pygtk-gtkprogressbar.xml	(original)
+++ trunk/docs/reference/pygtk-gtkprogressbar.xml	Sun Nov 30 23:20:21 2008
@@ -186,7 +186,77 @@
     <title>gtk.ProgressBar Style Properties</title>
 
     <para><link linkend="style-properties-gtkwidget">gtk.Widget Style Properties</link></para>
-
+    
+    <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>"min-horizontal-bar-height"</entry>
+	      <entry>Read</entry>
+	      <entry>
+		Minimum horizontal height of the progress bar.
+		Allowed values: >= 1. Default value: 20.
+		Available in GTK+ 2.14 and above.
+	      </entry>
+	    </row>
+
+	    <row valign="top">
+	      <entry>"min-horizontal-bar-width"</entry>
+	      <entry>Read</entry>
+	      <entry>
+		The minimum horizontal width of the progress bar.
+		Allowed values: >= 1. Default value: 150.
+		Available in GTK+ 2.14 and above.
+	      </entry>
+	    </row>
+
+	    <row valign="top">
+	      <entry>"min-vertical-bar-height"</entry>
+	      <entry>Read</entry>
+	      <entry>
+		The minimum vertical height of the progress bar.
+		Allowed values: >= 1. Default value: 80.
+		Available in GTK+ 2.14 and above.
+	      </entry>
+	    </row>
+
+	    <row valign="top">
+	      <entry>"min-vertical-bar-width"</entry>
+	      <entry>Read</entry>
+	      <entry>
+		The minimum vertical width of the progress bar.
+		Allowed values: >= 1. Default value: 22.
+		Available in GTK+ 2.14 and above.
+	      </entry>
+	    </row>
+
+	    <row valign="top">
+	      <entry>"xspacing"</entry>
+	      <entry>Read</entry>
+	      <entry>
+		Extra spacing applied to the width of a progress bar.
+		Allowed values: >= 0. Default value: 7.
+	      </entry>
+	    </row>
+
+	    <row valign="top">
+	      <entry>"yspacing"</entry>
+	      <entry>Read</entry>
+	      <entry>
+		Extra spacing applied to the width of a progress bar.
+		Allowed values: >= 0. Default value: 7.
+	      </entry>
+	    </row>
+
+	  </tbody>
+	</tgroup>
+      </informaltable>
+    </blockquote>
   </refsect1>
 
   <refsect1 id="signal-prototypes-gtkprogressbar">

Modified: trunk/docs/reference/pygtk-gtkrange.xml
==============================================================================
--- trunk/docs/reference/pygtk-gtkrange.xml	(original)
+++ trunk/docs/reference/pygtk-gtkrange.xml	Sun Nov 30 23:20:21 2008
@@ -233,6 +233,14 @@
 	    </row>
 
 	    <row valign="top">
+	      <entry>"arrow-scaling"</entry>
+	      <entry>Read</entry>
+	      <entry>The arrow size proportion relative to the scroll button size.
+	      Allowed values: [0,1]. Default value: 0.5.
+	      Available from GTK+ 2.14.</entry>
+	    </row>
+
+	    <row valign="top">
 	      <entry>"slider-width"</entry>
 	      <entry>Read</entry>
 	      <entry>The width of scrollbar or scale thumb</entry>

Modified: trunk/docs/reference/pygtk-gtkscalebutton.xml
==============================================================================
--- trunk/docs/reference/pygtk-gtkscalebutton.xml	(original)
+++ trunk/docs/reference/pygtk-gtkscalebutton.xml	Sun Nov 30 23:20:21 2008
@@ -28,6 +28,22 @@
         <methodparam></methodparam>
     </methodsynopsis>
     <methodsynopsis language="python">
+        <methodname><link linkend="method-gtkscalebutton--get-minus-button">get_minus_button</link></methodname>
+        <methodparam></methodparam>
+    </methodsynopsis>
+    <methodsynopsis language="python">
+        <methodname><link linkend="method-gtkscalebutton--get-orientation">get_orientation</link></methodname>
+        <methodparam></methodparam>
+    </methodsynopsis>
+    <methodsynopsis language="python">
+        <methodname><link linkend="method-gtkscalebutton--get-plus-button">get_plus_button</link></methodname>
+        <methodparam></methodparam>
+    </methodsynopsis>
+    <methodsynopsis language="python">
+        <methodname><link linkend="method-gtkscalebutton--get-popup">get_popup</link></methodname>
+        <methodparam></methodparam>
+    </methodsynopsis>
+    <methodsynopsis language="python">
         <methodname><link linkend="method-gtkscalebutton--get-value">get_value</link></methodname>
         <methodparam></methodparam>
     </methodsynopsis>
@@ -40,6 +56,10 @@
         <methodparam><parameter role="keyword">icons</parameter></methodparam>
     </methodsynopsis>
     <methodsynopsis language="python">
+        <methodname><link linkend="method-gtkscalebutton--set-orientation">set_orientation</link></methodname>
+        <methodparam><parameter role="keyword">icons</parameter></methodparam>
+    </methodsynopsis>
+    <methodsynopsis language="python">
         <methodname><link linkend="method-gtkscalebutton--set-value">set_value</link></methodname>
         <methodparam><parameter role="keyword">value</parameter></methodparam>
     </methodsynopsis>
@@ -112,6 +132,17 @@
                         </row>
 
                         <row valign="top">
+                            <entry>"orientation"</entry>
+                            <entry>Read/Write</entry>
+                            <entry>
+                                The orientation of the
+				<link linkend="class-gtkscalebutton"><classname>gtk.ScaleButton</classname></link>'s
+				popup window. Default value: gtk.ORIENTATION_VERTICAL.
+				Available from GTK+ 2.14.
+                            </entry>
+                        </row>
+
+                        <row valign="top">
                             <entry>"size"</entry>
                             <entry>Read/Write</entry>
                             <entry>
@@ -285,6 +316,120 @@
             </para>
         </refsect2>
 
+        <refsect2 id="method-gtkscalebutton--get-minus-button">
+            <title>gtk.ScaleButton.get_minus_button</title>
+
+            <programlisting><methodsynopsis language="python">
+                <methodname>get_minus_button</methodname>
+                <methodparam></methodparam>
+            </methodsynopsis></programlisting>
+            
+            <variablelist>
+                <varlistentry>
+                    <term><emphasis>Returns</emphasis>&nbsp;:</term>
+                        <listitem><simpara>the minus button of the
+			<link linkend="class-gtkscalebutton"><classname>gtk.ScaleButton</classname></link>.
+			</simpara></listitem>
+                </varlistentry>
+            </variablelist>
+
+            <note>
+                <para>This method is available in PyGTK 2.14 and above.</para>
+            </note>
+
+            <para>
+                The <methodname>get_minus_button</methodname>() method
+		retrieves the minus button of the
+		<link linkend="class-gtkscalebutton"><classname>gtk.ScaleButton</classname></link>.
+            </para>
+        </refsect2>
+
+        <refsect2 id="method-gtkscalebutton--get-orientation">
+            <title>gtk.ScaleButton.get_orientation</title>
+
+            <programlisting><methodsynopsis language="python">
+                <methodname>get_orientation</methodname>
+                <methodparam></methodparam>
+            </methodsynopsis></programlisting>
+            
+            <variablelist>
+                <varlistentry>
+                    <term><emphasis>Returns</emphasis>&nbsp;:</term>
+                        <listitem><simpara>the
+			<link linkend="class-gtkscalebutton"><classname>gtk.ScaleButton</classname></link>'s
+			orientation.
+			</simpara></listitem>
+                </varlistentry>
+            </variablelist>
+
+            <note>
+                <para>This method is available in PyGTK 2.14 and above.</para>
+            </note>
+
+            <para>
+                The <methodname>get_orientation</methodname>() method
+		gets the orientation of the
+		<link linkend="class-gtkscalebutton"><classname>gtk.ScaleButton</classname></link>'s
+		popup window.
+            </para>
+        </refsect2>
+
+        <refsect2 id="method-gtkscalebutton--get-plus-button">
+            <title>gtk.ScaleButton.get_plus_button</title>
+
+            <programlisting><methodsynopsis language="python">
+                <methodname>get_plus_button</methodname>
+                <methodparam></methodparam>
+            </methodsynopsis></programlisting>
+            
+            <variablelist>
+                <varlistentry>
+                    <term><emphasis>Returns</emphasis>&nbsp;:</term>
+                        <listitem><simpara>the plus button of the
+			<link linkend="class-gtkscalebutton"><classname>gtk.ScaleButton</classname></link>.
+			</simpara></listitem>
+                </varlistentry>
+            </variablelist>
+
+            <note>
+                <para>This method is available in PyGTK 2.14 and above.</para>
+            </note>
+
+            <para>
+                The <methodname>get_plus_button</methodname>() method
+		retrieves the plus button of the
+		<link linkend="class-gtkscalebutton"><classname>gtk.ScaleButton</classname></link>.
+            </para>
+        </refsect2>
+
+        <refsect2 id="method-gtkscalebutton--get-popup">
+            <title>gtk.ScaleButton.get_popup</title>
+
+            <programlisting><methodsynopsis language="python">
+                <methodname>get_popup</methodname>
+                <methodparam></methodparam>
+            </methodsynopsis></programlisting>
+            
+            <variablelist>
+                <varlistentry>
+                    <term><emphasis>Returns</emphasis>&nbsp;:</term>
+                        <listitem><simpara>the popup of the
+			<link linkend="class-gtkscalebutton"><classname>gtk.ScaleButton</classname></link>.
+			</simpara></listitem>
+                </varlistentry>
+            </variablelist>
+
+            <note>
+                <para>This method is available in PyGTK 2.14 and above.</para>
+            </note>
+
+            <para>
+                The <methodname>get_popup</methodname>() method
+		gets the popup of the
+		<link linkend="class-gtkscalebutton"><classname>gtk.ScaleButton</classname></link>.
+            </para>
+        </refsect2>
+
         <refsect2 id="method-gtkscalebutton--get-value">
             <title>gtk.ScaleButton.get_value</title>
 
@@ -367,6 +512,33 @@
             </para>
         </refsect2>
 
+        <refsect2 id="method-gtkscalebutton--set-orientation">
+            <title>gtk.ScaleButton.set_orientation</title>
+
+            <programlisting><methodsynopsis language="python">
+                <methodname>set_orientation</methodname>
+                <methodparam><parameter>icons</parameter></methodparam>
+            </methodsynopsis></programlisting>
+            
+            <variablelist>
+                <varlistentry>
+                    <term><parameter role="keyword">orientation</parameter>&nbsp;:</term>
+                        <listitem><simpara>the new orientation.</simpara></listitem>
+                </varlistentry>
+            </variablelist>
+
+            <note>
+                <para>This method is available in PyGTK 2.14 and above.</para>
+            </note>
+
+            <para>
+                The <methodname>set_orientation</methodname>() method sets the
+		orientation of the
+		<link linkend="class-gtkscalebutton"><classname>gtk.ScaleButton</classname></link>'s
+		popup window.
+            </para>
+        </refsect2>
+
         <refsect2 id="method-gtkscalebutton--set-value">
             <title>gtk.ScaleButton.set_value</title>
 

Modified: trunk/docs/reference/pygtk-gtksettings.xml
==============================================================================
--- trunk/docs/reference/pygtk-gtksettings.xml	(original)
+++ trunk/docs/reference/pygtk-gtksettings.xml	Sun Nov 30 23:20:21 2008
@@ -254,6 +254,28 @@
             </row>
             
             <row valign="top">
+              <entry>"gtk-enable-event-sounds"</entry>
+              <entry>Read-Write</entry>
+              <entry>Whether to play any event sounds at all. See the Sound
+	      Theme spec for more information on event sounds and sound themes.
+	      GTK+ itself does not support event sounds, you have to use a
+	      loadable module like the one that comes with libcanberra.
+	      Default value: <literal>True</literal>.
+              This property is available in GTK+ 2.14 and above.</entry>
+            </row>
+            
+            <row valign="top">
+              <entry>"gtk-enable-input-feedback-sounds"</entry>
+              <entry>Read-Write</entry>
+              <entry>Whether to play event sounds as feedback to user input.
+	      See the Sound Theme spec for more information on event sounds
+	      and sound themes. GTK+ itself does not support event sounds, you
+	      have to use a loadable module like the one that comes
+	      with libcanberra. Default value: <literal>True</literal>.
+              This property is available in GTK+ 2.14 and above.</entry>
+            </row>
+            
+            <row valign="top">
               <entry>"gtk-enable-mnemonics"</entry>
               <entry>Read-Write</entry>
               <entry>Whether labels and menu items should have visible mnemonics
@@ -261,6 +283,14 @@
               Default value: <literal>True</literal>.
               This property is available in GTK+ 2.12 and above.</entry>
             </row>
+            
+            <row valign="top">
+              <entry>"gtk-enable-tooltips"</entry>
+              <entry>Read-Write</entry>
+              <entry>Whether tooltips should be shown on widgets.
+	      Default value: <literal>True</literal>.
+              This property is available in GTK+ 2.14 and above.</entry>
+            </row>
 
             <row valign="top">
               <entry>"gtk-entry-password-hint-timeout"</entry>
@@ -412,6 +442,17 @@
               Allowed values: >= -1. Default value: 50.
               This property is available in GTK+ 2.12 and above.</entry>
             </row>
+            
+            <row valign="top">
+              <entry>"gtk-recent-files-max-age"</entry>
+              <entry>Read-Write</entry>
+              <entry>The maximum age, in days, of the items inside the recently
+	      used resources list. Items older than this setting will be excised
+	      from the list. If set to 0, the list will always be empty;
+	      if set to -1, no item will be removed. Allowed values: >= -1.
+	      Default value: 30
+              This property is available in GTK+ 2.14 and above.</entry>
+            </row>
 
             <row valign="top">
               <entry>"gtk-scrolled-window-placement"</entry>
@@ -437,6 +478,17 @@
               and text views should offer to insert control
               characters. Default value: <literal>True</literal>.</entry>
             </row>
+            
+            <row valign="top">
+              <entry>"gtk-sound-theme-name"</entry>
+              <entry>Read-Write</entry>
+              <entry>The XDG sound theme to use for event sounds. See the Sound
+	      Theme spec for more information on event sounds and sound themes.
+	      GTK+ itself does not support event sounds, you have to use a
+	      loadable module like the one that comes with libcanberra.
+	      Default value: "freedesktop".
+              This property is available in GTK+ 2.14 and above.</entry>
+            </row>
 
 	    <row valign="top">
 	      <entry>"gtk-split-cursor"</entry>

Modified: trunk/docs/reference/pygtk-gtkstatusicon.xml
==============================================================================
--- trunk/docs/reference/pygtk-gtkstatusicon.xml	(original)
+++ trunk/docs/reference/pygtk-gtkstatusicon.xml	Sun Nov 30 23:20:21 2008
@@ -21,23 +21,11 @@
         <methodparam></methodparam>
       </constructorsynopsis>
       <methodsynopsis language="python">
-        <methodname><link linkend="method-gtkstatusicon--set-from-pixbuf">set_from_pixbuf</link></methodname>
-        <methodparam><parameter role="keyword">pixbuf</parameter></methodparam>
-      </methodsynopsis>
-      <methodsynopsis language="python">
-        <methodname><link linkend="method-gtkstatusicon--set-from-file">set_from_file</link></methodname>
-        <methodparam><parameter role="keyword">filename</parameter></methodparam>
-      </methodsynopsis>
-      <methodsynopsis language="python">
-        <methodname><link linkend="method-gtkstatusicon--set-from-stock">set_from_stock</link></methodname>
-        <methodparam><parameter role="keyword">stock_id</parameter></methodparam>
-      </methodsynopsis>
-      <methodsynopsis language="python">
-        <methodname><link linkend="method-gtkstatusicon--set-from-icon-name">set_from_icon_name</link></methodname>
-        <methodparam><parameter role="keyword">icon_name</parameter></methodparam>
+        <methodname><link linkend="method-gtkstatusicon--get-storage-type">get_storage_type</link></methodname>
+        <methodparam></methodparam>
       </methodsynopsis>
       <methodsynopsis language="python">
-        <methodname><link linkend="method-gtkstatusicon--get-storage-type">get_storage_type</link></methodname>
+        <methodname><link linkend="method-gtkstatusicon--get-gicon">get_gicon</link></methodname>
         <methodparam></methodparam>
       </methodsynopsis>
       <methodsynopsis language="python">
@@ -57,6 +45,10 @@
         <methodparam></methodparam>
       </methodsynopsis>
       <methodsynopsis language="python">
+        <methodname><link linkend="method-gtkstatusicon--get-x11-window-id">get_x11_window_id</link></methodname>
+        <methodparam></methodparam>
+      </methodsynopsis>
+      <methodsynopsis language="python">
         <methodname><link linkend="method-gtkstatusicon--set-tooltip">set_tooltip</link></methodname>
         <methodparam><parameter role="keyword">tooltip_text</parameter></methodparam>
       </methodsynopsis>
@@ -94,6 +86,26 @@
         <methodname><link linkend="method-gtkstatusicon--set-screen">set_screen</link></methodname>
         <methodparam><parameter role="keyword">screen</parameter></methodparam>
       </methodsynopsis>
+      <methodsynopsis language="python">
+        <methodname><link linkend="method-gtkstatusicon--set-from-pixbuf">set_from_pixbuf</link></methodname>
+        <methodparam><parameter role="keyword">pixbuf</parameter></methodparam>
+      </methodsynopsis>
+      <methodsynopsis language="python">
+        <methodname><link linkend="method-gtkstatusicon--set-from-file">set_from_file</link></methodname>
+        <methodparam><parameter role="keyword">filename</parameter></methodparam>
+      </methodsynopsis>
+      <methodsynopsis language="python">
+        <methodname><link linkend="method-gtkstatusicon--set-from-stock">set_from_stock</link></methodname>
+        <methodparam><parameter role="keyword">stock_id</parameter></methodparam>
+      </methodsynopsis>
+      <methodsynopsis language="python">
+        <methodname><link linkend="method-gtkstatusicon--set-from-icon-name">set_from_icon_name</link></methodname>
+        <methodparam><parameter role="keyword">icon_name</parameter></methodparam>
+      </methodsynopsis>
+      <methodsynopsis language="python">
+        <methodname><link linkend="method-gtkstatusicon--set-from-gicon">set_from_gicon</link></methodname>
+        <methodparam><parameter role="keyword">gicon</parameter></methodparam>
+      </methodsynopsis>
 </classsynopsis>
 
 <programlisting>
@@ -106,6 +118,9 @@
     <methodname><link linkend="function-gtk--status-icon-new-from-file">gtk.status_icon_new_from_file</link></methodname>
     <methodparam><parameter role="keyword">filename</parameter></methodparam>
   </methodsynopsis><methodsynopsis language="python">
+    <methodname><link linkend="function-gtk--status-icon-new-from-gicon">gtk.status_icon_new_from_gicon</link></methodname>
+    <methodparam><parameter role="keyword">filename</parameter></methodparam>
+  </methodsynopsis><methodsynopsis language="python">
     <methodname><link linkend="function-gtk--status-icon-new-from-stock">gtk.status_icon_new_from_stock</link></methodname>
     <methodparam><parameter role="keyword">stock_id</parameter></methodparam>
   </methodsynopsis><methodsynopsis language="python">
@@ -163,6 +178,14 @@
         </row>
 
         <row valign="top">
+          <entry>"gicon"</entry>
+          <entry>Read-Write</entry>
+          <entry>The GIcon displayed in the GtkStatusIcon. For themed icons,
+          the image will be updated automatically if the theme changes.</entry>
+          Available from GTK+ 2.14.
+        </row>
+
+        <row valign="top">
           <entry>"icon-name"</entry>
           <entry>Read-Write</entry>
           <entry>The name of the icon from the icon theme. Default value:
@@ -438,6 +461,31 @@
 
     </refsect2>
 
+    <refsect2 id="method-gtkstatusicon--set-from-gicon">
+      <title>gtk.StatusIcon.set_from_gicon</title>
+
+      <programlisting><methodsynopsis language="python">
+        <methodname>set_from_gicon</methodname>
+        <methodparam><parameter role="keyword">gicon</parameter></methodparam>
+      </methodsynopsis></programlisting>
+
+      <variablelist>
+        <varlistentry>
+          <term><parameter role="keyword">gicon</parameter>&nbsp;:</term>
+          <listitem><simpara>a gio.Icon()</simpara></listitem>
+        </varlistentry>
+      </variablelist>
+
+      <note>
+        <para>This method is available in PyGTK 2.14  and above.</para>
+      </note>
+
+      <para>Makes <parameter>status_icon</parameter> display the <parameter>gio.Icon()</parameter>
+      See <methodname><link linkend="function-gtk--status-icon-new-from-gicon">gtk.status_icon_new_from_gicon</link></methodname>()
+      for details</para>
+
+    </refsect2>
+
     <refsect2 id="method-gtkstatusicon--get-storage-type">
       <title>gtk.StatusIcon.get_storage_type</title>
 
@@ -468,6 +516,71 @@
 
     </refsect2>
 
+    <refsect2 id="method-gtkstatusicon--get-gicon">
+      <title>gtk.StatusIcon.get_gicon</title>
+
+      <programlisting><methodsynopsis language="python">
+        <methodname>get_gicon</methodname>
+        <methodparam></methodparam>
+      </methodsynopsis></programlisting>
+
+      <variablelist>
+        <varlistentry>
+          <term><emphasis>Returns</emphasis>&nbsp;:</term>
+          <listitem><simpara>the displayed icon, or <literal>None</literal>
+          if the image is empty.</simpara></listitem>
+        </varlistentry>
+      </variablelist>
+
+      <note>
+        <para>This method is available in PyGTK 2.14 and above.</para>
+      </note>
+
+      <para>
+        Retrieves the gio.Icon() being displayed by the
+        <link linkend="class-gtkstatusicon"><classname>gtk.StatusIcon</classname></link>.
+        The storage type of the status icon must be gtk.IMAGE_EMPTY or gtk.IMAGE_GICON.
+        If this method fails, icon is left unchanged;
+      </para>
+
+    </refsect2>
+
+    <refsect2 id="method-gtkstatusicon--get-x11-window-id">
+      <title>gtk.StatusIcon.get_x11_window_id</title>
+
+      <programlisting><methodsynopsis language="python">
+        <methodname>get_x11_window_id</methodname>
+        <methodparam></methodparam>
+      </methodsynopsis></programlisting>
+
+      <variablelist>
+        <varlistentry>
+          <term><emphasis>Returns</emphasis>&nbsp;:</term>
+          <listitem><simpara>An 32 bit unsigned integer identifier for the
+          underlying X11 Window.</simpara></listitem>
+        </varlistentry>
+      </variablelist>
+
+      <note>
+        <para>This method is available in PyGTK 2.14 and above.</para>
+      </note>
+
+      <para>
+        This function is only useful on the X11/freedesktop.org platform. It
+        returns a window ID for the widget in the underlying status icon
+        implementation. This is useful for the Galago notification service,
+        which can send a window ID in the protocol in order for the server
+        to position notification windows pointing to a status icon reliably.
+      </para>
+      <para>
+        This function is not intended for other use cases which are more likely
+        to be met by one of the non-X11 specific methods,
+        such as
+        <methodname><link linkend="function-gtk--status-icon-position-menu">gtk.status_icon_position_menu</link></methodname>().
+      </para>
+
+    </refsect2>
+
     <refsect2 id="method-gtkstatusicon--get-pixbuf">
       <title>gtk.StatusIcon.get_pixbuf</title>
 
@@ -891,6 +1004,33 @@
 
     </refsect2>
 
+    <refsect2 id="function-gtk--status-icon-new-from-gicon">
+      <title>gtk.status_icon_new_from_gicon</title>
+
+      <programlisting><methodsynopsis language="python">
+	  <methodname>gtk.status_icon_new_from_gicon</methodname>
+	  <methodparam><parameter
+			 role="keyword">gicon</parameter></methodparam>
+	</methodsynopsis></programlisting>
+      <variablelist>
+	<varlistentry>
+	  <term><parameter role="keyword">gicon</parameter>&nbsp;:</term>
+	  <listitem><simpara></simpara></listitem>
+	</varlistentry>
+	<varlistentry>
+	<term><emphasis>Returns</emphasis>&nbsp;:</term>
+	  <listitem><simpara>a new <link
+	  linkend="class-gtkstatusicon"><classname>gtk.StatusIcon</classname></link></simpara></listitem>
+	</varlistentry>
+      </variablelist>
+
+      <para>
+        Creates a status icon displaying a gio.Icon(). If the icon is a
+        themed icon, it will be updated when the theme changes.
+      </para>
+
+    </refsect2>
+
     <refsect2 id="function-gtk--status-icon-new-from-stock">
       <title>gtk.status_icon_new_from_stock</title>
 



[Date Prev][Date Next]   [Thread Prev][Thread Next]   [Thread Index] [Date Index] [Author Index]