anant		Thu Dec 13 20:18:18 2007 UTC

  Added files:                 
    /php-gtk-doc/examples/reference/gtk/gtkstatusicon	traysimple.phpw 
    /php-gtk-doc/images/reference/gtk	gtkstatusicon.png 

  Modified files:              
    /php-gtk-doc/manual/en/reference/gtk	gtkstatusicon.xml 
  Log:
  Add GtkStatusIcon docs by Jared Hurn.
  
  
http://cvs.php.net/viewvc.cgi/php-gtk-doc/manual/en/reference/gtk/gtkstatusicon.xml?r1=1.1&r2=1.2&diff_format=u
Index: php-gtk-doc/manual/en/reference/gtk/gtkstatusicon.xml
diff -u php-gtk-doc/manual/en/reference/gtk/gtkstatusicon.xml:1.1 php-gtk-doc/manual/en/reference/gtk/gtkstatusicon.xml:1.2
--- php-gtk-doc/manual/en/reference/gtk/gtkstatusicon.xml:1.1	Wed Oct 17 09:10:13 2007
+++ php-gtk-doc/manual/en/reference/gtk/gtkstatusicon.xml	Thu Dec 13 20:18:18 2007
@@ -1,213 +1,588 @@
-<?xml version="1.0" encoding="utf-8"?>
-<!-- $Revision: 1.1 $ -->
-<classentry id="gtk.gtkstatusicon">
- <classmeta>
-  <classtitle>GtkStatusIcon</classtitle>
-  <classparent>GObject</classparent>
-  <shortdesc>
-   <classname>GtkStatusIcon</classname> is used for displaying an icon in the
-   system tray.
-  </shortdesc>
-  <desc>
-   <para>
-   </para>
-  </desc>
- </classmeta>
-
-
- <methods>
-
-  <method id="gtk.statusicon.method.position_menu">
-   <funcsynopsis>
-    <funcprototype>
-     <funcdef>void <function>position_menu</function></funcdef>
-     <paramdef><classname>GtkMenu</classname> <parameter><optional>menu</optional></parameter></paramdef>
-     <paramdef><classname>GtkStatusIcon</classname> <parameter><optional>statusicon</optional></parameter></paramdef>
-    </funcprototype>
-   </funcsynopsis>
-   <shortdesc>
-    Menu positioning function for use with <function class="GtkMenu">popup</function>
-   </shortdesc>
-   <desc>
-    <simpara>
-     &static;
-    </simpara>
-    <para>
-     Menu positioning function for use with <function class="GtkMenu">popup</function>
-    </para>
-   </desc>
-  </method>
-
-  <method id="gtk.gtkstatusicon.method.set_from_pixbuf">
-   <funcsynopsis>
-    <funcprototype>
-     <funcdef>void <function>set_from_pixbuf</function></funcdef>
-     <paramdef><classname>GdkPixbuf</classname> <parameter>pixbuf</parameter></paramdef>
-    </funcprototype>
-   </funcsynopsis>
-   <shortdesc>
-    Sets the GdkPixbuf being displayed by the GtkStatusIcon.
-   </shortdesc>
-   <desc>
-    <para>
-     Sets the GdkPixbuf being displayed by the GtkStatusIcon.
-    </para>
-    <para>
-     &seealso;
-     <function class="GtkStatusIcon">get_pixbuf</function>
-    </para>
-   </desc>
-  </method>
-
-  <method id="gtk.gtkstatusicon.method.get_pixbuf">
-   <funcsynopsis>
-    <funcprototype>
-     <funcdef><classname>GdkPixbuf</classname> <function>get_pixbuf</function></funcdef>
-     <paramdef>void</paramdef>
-    </funcprototype>
-   </funcsynopsis>
-   <shortdesc>
-    Gets the GdkPixbuf being displayed by the GtkStatusIcon.
-   </shortdesc>
-   <desc>
-    <para>
-     Gets the GdkPixbuf being displayed by the GtkStatusIcon.
-    </para>
-    <para>
-     &seealso;
-     <function class="GtkStatusIcon">set_from_pixbuf</function>
-    </para>
-   </desc>
-  </method>
-
-  <method id="gtk.gtkstatusicon.method.set_visible">
-   <funcsynopsis>
-    <funcprototype>
-     <funcdef>void <function>set_visible</function></funcdef>
-     <paramdef>bool <parameter>visible</parameter></paramdef>
-    </funcprototype>
-   </funcsynopsis>
-   <shortdesc>
-    Sets the visibility of the GtkStatusIcon.
-   </shortdesc>
-   <desc>
-    <para>
-     Sets the visibility of the GtkStatusIcon.
-    </para>
-    <para>
-     &seealso;
-     <function class="GtkStatusIcon">get_visible</function>
-    </para>
-   </desc>
-  </method>
-
-  <method id="gtk.gtkstatusicon.method.get_visible">
-   <funcsynopsis>
-    <funcprototype>
-     <funcdef>bool <function>get_visible</function></funcdef>
-     <paramdef>void</paramdef>
-    </funcprototype>
-   </funcsynopsis>
-   <shortdesc>
-    Returns whether or not the GtkStatusIcon is visible.
-   </shortdesc>
-   <desc>
-    <para>
-     Returns whether or not the GtkStatusIcon is visible.
-    </para>
-    <para>
-     &seealso;
-     <function class="GtkStatusIcon">set_blinking</function>
-    </para>
-   </desc>
-  </method>
-
-  <method id="gtk.gtkstatusicon.method.set_blinking">
-   <funcsynopsis>
-    <funcprototype>
-     <funcdef>bool <function>set_blinking</function></funcdef>
-     <paramdef>bool <parameter>blinking</parameter></paramdef>
-    </funcprototype>
-   </funcsynopsis>
-   <shortdesc>
-    Sets the blinking state of the GtkStatusIcon.
-   </shortdesc>
-   <desc>
-    <para>
-     Sets the blinking state of the GtkStatusIcon.
-    </para>
-    <para>
-     &seealso;
-     <function class="GtkStatusIcon">get_blinking</function>
-    </para>
-   </desc>
-  </method>
-
-  <method id="gtk.gtkstatusicon.method.get_blinking">
-   <funcsynopsis>
-    <funcprototype>
-     <funcdef>bool <function>get_blinking</function></funcdef>
-     <paramdef>void</paramdef>
-    </funcprototype>
-   </funcsynopsis>
-   <shortdesc>
-    Returns whether or not the GtkStatusIcon is blinking.
-   </shortdesc>
-   <desc>
-    <para>
-     Returns whether or not the GtkStatusIcon is blinking.
-    </para>
-    <para>
-     &seealso;
-     <function class="GtkStatusIcon">set_blinking</function>
-    </para>
-   </desc>
-  </method>
-
-  <method id="gtk.gtkstatusicon.method.set_tooltip">
-   <funcsynopsis>
-    <funcprototype>
-     <funcdef>void <function>set_tooltip</function></funcdef>
-     <paramdef>string <parameter>tip_text</parameter></paramdef>
-    </funcprototype>
-   </funcsynopsis>
-   <shortdesc>
-    Sets the tooltip for the GtkStatusIcon.
-   </shortdesc>
-   <desc>
-    <para>
-     Sets the tooltip for the GtkStatusIcon.
-    </para>
-   </desc>
-  </method>
-
- </methods>
-
- <signals>
-  <signal id="gtk.gtkstatusicon.signal.activate">
-   <signalname>activate</signalname>
-   <funcsynopsis>
-    <funcprototype>
-     <funcdef>void <function>callback</function></funcdef>
-     <paramdef>GtkWidget <parameter>widget</parameter></paramdef>
-    </funcprototype>
-   </funcsynopsis>
-   <shortdesc>
-    Signal for left mouse clicks.
-   </shortdesc>
-  </signal>
-  <signal id="gtk.gtkstatusicon.signal.popup-menu">
-   <signalname>popup-menu</signalname>
-   <funcsynopsis>
-    <funcprototype>
-     <funcdef>void <function>callback</function></funcdef>
-     <paramdef>GtkWidget <parameter>widget</parameter></paramdef>
-    </funcprototype>
-   </funcsynopsis>
-   <shortdesc>
-    Signal for right mouse clicks.
-   </shortdesc>
-  </signal>
- </signals>
-
-</classentry>
+<?xml version="1.0" encoding="utf-8"?>
+<!-- $Revision: 1.2 $ -->
+<classentry id="gtk.gtkstatusicon">
+ <classmeta>
+  <classtitle>GtkStatusIcon</classtitle>
+  <classparent>GObject</classparent>
+  <classimage fileref="&directory.images;/reference/gtk/gtkstatusicon.png"/>
+  <shortdesc>
+   <classname>GtkStatusIcon</classname> is used for displaying an icon in the
+   system tray.
+  </shortdesc>
+  <desc>
+   <para>
+    <classname>GtkStatusIcon</classname> is used for displaying an icon in the
+    system tray. The system tray is generally used to indicate some special
+    state that a user would be interested in.
+   </para>
+   <para>
+    A <classname>GtkStatusIcon</classname> object can be assigned
+    a tooltip, handle <signalname class="GtkStatusIcon">activate</signalname>
+    and <signalname class="GtkStatusIcon">popup-menu</signalname> signals,
+    set to blink, and set invisible. All of these states and settings can help
+    the user more easily identify the type of notification being displayed to
+    them.
+   </para>
+   <note>
+    <classname>GtkStatusIcon</classname> is a <classname>GObject</classname>,
+    NOT a <classname>GtkWidget</classname>.
+   </note>
+   <para>
+    <example>
+     <title>Simple Tray Application</title>
+     <programlisting role="php">
+      <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
+                  href="&directory.examples;/reference/gtk/gtkstatusicon/traysimple.phpw"
+                  parse="text">
+       <xi:fallback>FIXME: MISSING XINCLUDE CONTENT</xi:fallback>
+      </xi:include>
+     </programlisting>
+    </example>
+   </para>
+  </desc>
+ </classmeta>
+
+ <constructors>
+
+  <constructor id="gtk.statusicon.constructor">
+   <funcsynopsis>
+    <funcprototype>
+    <funcdef> <function>GtkStatusIcon</function></funcdef>
+    <paramdef>void</paramdef>
+    </funcprototype>
+   </funcsynopsis>
+   <shortdesc>
+    Creates a new object.
+   </shortdesc>
+   <desc>
+    <para>
+     Creates a new <classname>GtkStatusIcon</classname>.
+    </para>
+    <para>
+     <informalexample>
+      <programlisting role="php"><![CDATA[
+$tray = new GtkStatusIcon();
+]]></programlisting>
+     </informalexample>
+    </para>
+   </desc>
+  </constructor>
+
+  <constructor id="gtk.statusicon.constructor.new_from_file">
+   <funcsynopsis>
+    <funcprototype>
+     <funcdef> <function>GtkStatusIcon::new_from_file</function></funcdef>
+      <paramdef>string <parameter>filepath</parameter></paramdef>
+    </funcprototype>
+   </funcsynopsis>
+   <shortdesc>
+    Creates a new object using the supplied filepath.
+   </shortdesc>
+   <desc>
+    <para>
+     Creates a new <classname>GtkStatusIcon</classname> using the supplied
+     filepath. The icon image should easily identify the state of the item being
+     monitored by the user.
+    </para>
+    <para>
+     &static;
+    </para>
+    <para>
+     <informalexample>
+      <programlisting role="php"><![CDATA[
+$tray = GtkStatusIcon::new_from_file('icon.png');
+]]></programlisting>
+     </informalexample>
+    </para>
+    <para>
+     &seealso;
+     <function class="GtkStatusIcon">set_from_file</function>
+    </para>
+   </desc>
+  </constructor>
+
+  <constructor id="gtk.statusicon.constructor.new_from_pixbuf">
+   <funcsynopsis>
+    <funcprototype>
+     <funcdef> <function>GtkStatusIcon::new_from_pixbuf</function></funcdef>
+      <paramdef><classname>GdkPixbuf</classname> <parameter>pixbuf</parameter></paramdef>
+    </funcprototype>
+   </funcsynopsis>
+   <shortdesc>
+    Creates a new object using the supplied <classname>GdkPixbuf</classname>.
+   </shortdesc>
+   <desc>
+    <para>
+     Creates a new <classname>GtkStatusIcon</classname> using the supplied
+     <classname>GdkPixbuf</classname>. The icon image should easily identify the
+     state of the item being monitored by the user.
+    </para>
+    <para>
+     &static;
+    </para>
+    <para>
+     <informalexample>
+      <programlisting role="php"><![CDATA[
+$pixbuf = GdkPixbuf::new_from_file('icon.png');
+$tray = GtkStatusIcon::new_from_pixbuf($pixbuf);
+]]></programlisting>
+     </informalexample>
+    </para>
+    <para>
+     &seealso;
+     <function class="GtkStatusIcon">set_from_pixbuf</function>
+    </para>
+   </desc>
+  </constructor>
+
+  <constructor id="gtk.statusicon.constructor.new_from_stock">
+   <funcsynopsis>
+    <funcprototype>
+     <funcdef> <function>GtkStatusIcon::new_from_stock</function></funcdef>
+      <paramdef><enumname>GtkStockItems</enumname> <parameter>stock_id</parameter></paramdef>
+    </funcprototype>
+   </funcsynopsis>
+   <shortdesc>
+    Creates a new object using the supplied stock_id.
+   </shortdesc>
+   <desc>
+    <para>
+     Creates a new <classname>GtkStatusIcon</classname> using the supplied
+     stock_id. The icon image should easily identify the state of the item being
+     monitored by the user.
+    </para>
+    <para>
+     &static;
+    </para>
+    <para>
+     <informalexample>
+      <programlisting role="php"><![CDATA[
+$tray = GtkStatusIcon::new_from_stock(Gtk::STOCK_EXECUTE);
+]]></programlisting>
+     </informalexample>
+    </para>
+    <para>
+     &seealso;
+     <function class="GtkStatusIcon">set_from_stock</function>
+    </para>
+   </desc>
+  </constructor>
+
+ </constructors>
+
+ <methods>
+
+  <method id="gtk.gtkstatusicon.method.is_embedded">
+   <funcsynopsis>
+    <funcprototype>
+     <funcdef>bool <function>is_embedded</function></funcdef>
+     <paramdef>void</paramdef>
+    </funcprototype>
+   </funcsynopsis>
+   <shortdesc>
+    Get embedded state of the object.
+   </shortdesc>
+   <desc>
+    <para>
+     Get embedded state of the <classname>GtkStatusIcon</classname> object. If
+     a <classname>GtkStatusIcon</classname> is embedded, then no system tray is
+     accessible on the host machine.
+    </para>
+    <para>
+     <informalexample>
+      <programlisting role="php"><![CDATA[
+$tray = new GtkStatusIcon();
+if ($tray->is_embedded()) {
+  echo 'No system tray available!';
+}
+]]></programlisting>
+     </informalexample>
+    </para>
+   </desc>
+  </method>
+
+  <method id="gtk.gtkstatusicon.method.get_blinking">
+   <funcsynopsis>
+    <funcprototype>
+     <funcdef>bool <function>get_blinking</function></funcdef>
+     <paramdef>void</paramdef>
+    </funcprototype>
+   </funcsynopsis>
+   <shortdesc>
+    Get blinking state of the object.
+   </shortdesc>
+   <desc>
+    <para>
+     Get blinking state of the <classname>GtkStatusIcon</classname> object.
+     A blinking state generally indicates a special state that requires the
+     user's attention.
+    </para>
+    <note>
+     Not all systems support the blinking state.
+    </note>
+    <para>
+     <informalexample>
+      <programlisting role="php"><![CDATA[
+$tray = new GtkStatusIcon();
+$is_blinking = $tray->get_blinking();
+]]></programlisting>
+     </informalexample>
+    </para>
+    <para>
+     &seealso;
+     <function class="GtkStatusIcon">set_blinking</function>
+    </para>
+   </desc>
+  </method>
+
+  <method id="gtk.gtkstatusicon.method.get_pixbuf">
+   <funcsynopsis>
+    <funcprototype>
+     <funcdef><classname>GdkPixbuf</classname> <function>get_pixbuf</function></funcdef>
+     <paramdef>void</paramdef>
+    </funcprototype>
+   </funcsynopsis>
+   <shortdesc>
+    Get <classname>GdkPixbuf</classname> icon image of the object.
+   </shortdesc>
+   <desc>
+    <para>
+     Get <classname>GdkPixbuf</classname> icon image of the object.
+    </para>
+    <para>
+     <informalexample>
+      <programlisting role="php"><![CDATA[
+$tray = new GtkStatusIcon();
+$pixbuf_in = GdkPixbuf::new_from_file('icon.png');
+$tray->set_from_pixbuf($pixbuf);
+$pixbuf_out = $tray->get_pixbuf();
+]]></programlisting>
+     </informalexample>
+    </para>
+    <para>
+     &seealso;
+     <function class="GtkStatusIcon">set_from_pixbuf</function>
+    </para>
+   </desc>
+  </method>
+
+  <method id="gtk.gtkstatusicon.method.get_size">
+   <funcsynopsis>
+    <funcprototype>
+     <funcdef>int <function>get_size</function></funcdef>
+     <paramdef>void</paramdef>
+    </funcprototype>
+   </funcsynopsis>
+   <shortdesc>
+    Get image size of the object.
+   </shortdesc>
+   <desc>
+    <para>
+     Get image size of the <classname>GtkStatusIcon</classname> object.
+    </para>
+    <para>
+     <informalexample>
+      <programlisting role="php"><![CDATA[
+$tray = new GtkStatusIcon();
+$tray->set_from_stock(Gtk::STOCK_EXECUTE);
+echo $tray->get_size();
+// 16
+]]></programlisting>
+     </informalexample>
+    </para>
+   </desc>
+  </method>
+
+  <method id="gtk.gtkstatusicon.method.get_visible">
+   <funcsynopsis>
+    <funcprototype>
+     <funcdef>bool <function>get_visible</function></funcdef>
+     <paramdef>void</paramdef>
+    </funcprototype>
+   </funcsynopsis>
+   <shortdesc>
+    Get visibility state of the object.
+   </shortdesc>
+   <desc>
+    <para>
+     Get visibility state of the <classname>GtkStatusIcon</classname> object.
+     An invisible state is useful for applications that do not require the
+     constant reporting of the current state to the user. An example would be an
+     auto updater for an application, that only displays an icon when an update
+     is available.
+    </para>
+    <para>
+     <informalexample>
+      <programlisting role="php"><![CDATA[
+$tray = new GtkStatusIcon();
+$is_visible = $tray->get_visible();
+]]></programlisting>
+     </informalexample>
+    </para>
+    <para>
+     &seealso;
+     <function class="GtkStatusIcon">set_visible</function>
+    </para>
+   </desc>
+  </method>
+
+  <method id="gtk.statusicon.method.position_menu">
+   <funcsynopsis>
+    <funcprototype>
+     <funcdef>void <function>position_menu</function></funcdef>
+     <paramdef><classname>GtkMenu</classname> <parameter><optional>menu</optional></parameter></paramdef>
+     <paramdef><classname>GtkStatusIcon</classname> <parameter><optional>statusicon</optional></parameter></paramdef>
+    </funcprototype>
+   </funcsynopsis>
+   <shortdesc>
+    Use to position a popup menu over the object.
+   </shortdesc>
+   <desc>
+    <para>
+     Use to position a menu over a <classname>GtkStatusIcon</classname> object.
+     This function makes sure the supplied menu is displayed over the icon when
+     <function class="GtkMenu">popup</function> is called.
+    </para>
+    <para>
+     &static;
+    </para>
+    <para>
+     <informalexample>
+      <programlisting role="php"><![CDATA[
+$menu = new GtkMenu();
+$tray = new GtkStatusIcon();
+GtkStatusIcon::position_menu($menu, $tray);
+]]></programlisting>
+     </informalexample>
+    </para>
+   </desc>
+  </method>
+
+  <method id="gtk.gtkstatusicon.method.set_blinking">
+   <funcsynopsis>
+    <funcprototype>
+     <funcdef>bool <function>set_blinking</function></funcdef>
+     <paramdef>bool <parameter>blinking</parameter></paramdef>
+    </funcprototype>
+   </funcsynopsis>
+   <shortdesc>
+    Set blinking state of the object.
+   </shortdesc>
+   <desc>
+    <para>
+     Set blinking state of the <classname>GtkStatusIcon</classname> object.
+     A blinking state generally indicates a special state that requires the
+     user's attention.
+    </para>
+    <note>
+     Not all systems support the blinking state.
+	</note>
+    <para>
+     <informalexample>
+      <programlisting role="php"><![CDATA[
+$tray = new GtkStatusIcon();
+$tray->set_blinking(false);
+]]></programlisting>
+     </informalexample>
+    </para>
+    <para>
+     &seealso;
+     <function class="GtkStatusIcon">get_blinking</function>
+    </para>
+   </desc>
+  </method>
+
+  <method id="gtk.gtkstatusicon.method.set_from_file">
+   <funcsynopsis>
+    <funcprototype>
+     <funcdef>void <function>set_from_file</function></funcdef>
+     <paramdef>string <parameter>filepath</parameter></paramdef>
+    </funcprototype>
+   </funcsynopsis>
+   <shortdesc>
+    Set icon image of the object using the supplied filepath.
+   </shortdesc>
+   <desc>
+    <para>
+     Set icon image of the <classname>GtkStatusIcon</classname> using the
+     supplied filepath. The icon image should easily identify the state of the
+     item being monitored by the user.
+    </para>
+    <para>
+     <informalexample>
+      <programlisting role="php"><![CDATA[
+$tray = new GtkStatusIcon();
+$tray->set_from_file('icon.png');
+]]></programlisting>
+     </informalexample>
+    </para>
+    <para>
+     &seealso;
+     <function class="GtkStatusIcon">GtkStatusIcon::new_from_file</function>
+    </para>
+   </desc>
+  </method>
+
+  <method id="gtk.gtkstatusicon.method.set_from_pixbuf">
+   <funcsynopsis>
+    <funcprototype>
+     <funcdef>void <function>set_from_pixbuf</function></funcdef>
+     <paramdef><classname>GdkPixbuf</classname> <parameter>pixbuf</parameter></paramdef>
+    </funcprototype>
+   </funcsynopsis>
+   <shortdesc>
+    Set icon image of the object using the supplied <classname>GdkPixbuf</classname>.
+   </shortdesc>
+   <desc>
+    <para>
+     Set icon image of the <classname>GtkStatusIcon</classname> using the
+     supplied <classname>GdkPixbuf</classname>. The icon image should easily
+     identify the state of the item being monitored by the user.
+    </para>
+    <para>
+     <informalexample>
+      <programlisting role="php"><![CDATA[
+$tray = new GtkStatusIcon();
+$pixbuf = GdkPixbuf::new_from_file('icon.png');
+$tray->set_from_pixbuf($pixbuf);
+]]></programlisting>
+     </informalexample>
+    </para>
+    <para>
+     &seealso;
+     <function class="GtkStatusIcon">GtkStatusIcon::new_from_pixbuf</function>
+    </para>
+   </desc>
+  </method>
+
+  <method id="gtk.gtkstatusicon.method.set_from_stock">
+   <funcsynopsis>
+    <funcprototype>
+     <funcdef>void <function>set_from_stock</function></funcdef>
+     <paramdef><enumname>GtkStockItems</enumname> <parameter>stock_id</parameter></paramdef>
+    </funcprototype>
+   </funcsynopsis>
+   <shortdesc>
+    Set icon image of the object using the supplied stock_id.
+   </shortdesc>
+   <desc>
+    <para>
+     Set icon image of the <classname>GtkStatusIcon</classname> using the
+     supplied stock_id. The icon image should easily identify the state of the
+     item being monitored by the user.
+    </para>
+    <para>
+     <informalexample>
+      <programlisting role="php"><![CDATA[
+$tray = new GtkStatusIcon();
+$tray->set_from_stock(Gtk::STOCK_EXECUTE);
+]]></programlisting>
+     </informalexample>
+    </para>
+    <para>
+     &seealso;
+     <function class="GtkStatusIcon">GtkStatusIcon::new_from_stock</function>
+    </para>
+   </desc>
+  </method>
+
+  <method id="gtk.gtkstatusicon.method.set_tooltip">
+   <funcsynopsis>
+    <funcprototype>
+     <funcdef>void <function>set_tooltip</function></funcdef>
+     <paramdef>string <parameter>tooltip</parameter></paramdef>
+    </funcprototype>
+   </funcsynopsis>
+   <shortdesc>
+    Set tooltip text of the object.
+   </shortdesc>
+   <desc>
+    <para>
+     Set tooltip to display for the <classname>GtkStatusIcon</classname> object.
+     A tooltip is a short description that will be displayed to the user when
+     they hover their mouse pointer over the icon.
+    </para>
+    <para>
+     <informalexample>
+      <programlisting role="php"><![CDATA[
+$tray = new GtkStatusIcon();
+$tray->set_tooltip('This is a GtkStatusIcon object');
+]]></programlisting>
+     </informalexample>
+    </para>
+   </desc>
+  </method>
+
+  <method id="gtk.gtkstatusicon.method.set_visible">
+   <funcsynopsis>
+    <funcprototype>
+     <funcdef>void <function>set_visible</function></funcdef>
+     <paramdef>bool <parameter>visible</parameter></paramdef>
+    </funcprototype>
+   </funcsynopsis>
+   <shortdesc>
+    Set visibility state of the object.
+   </shortdesc>
+   <desc>
+    <para>
+     Set visibility state of the <classname>GtkStatusIcon</classname> object.
+     An invisible state is useful for applications that do not require the
+     constant reporting of the current state to the user. An example would be an
+     auto updater for an application, that only displays an icon when an update
+     is available.
+    </para>
+    <para>
+     <informalexample>
+      <programlisting role="php"><![CDATA[
+$tray = new GtkStatusIcon();
+$tray->set_visible(false);
+]]></programlisting>
+     </informalexample>
+    </para>
+    <para>
+     &seealso;
+     <function class="GtkStatusIcon">get_visible</function>
+    </para>
+   </desc>
+  </method>
+
+ </methods>
+
+ <signals>
+  <signal id="gtk.gtkstatusicon.signal.activate">
+   <signalname>activate</signalname>
+   <funcsynopsis>
+    <funcprototype>
+     <funcdef>void <function>callback</function></funcdef>
+     <paramdef>GtkWidget <parameter>widget</parameter></paramdef>
+    </funcprototype>
+   </funcsynopsis>
+   <shortdesc>
+    Signal emitted on a left mouse button click.
+   </shortdesc>
+   <desc>
+    <para>
+     Signal emitted on a left mouse button click.
+    </para>
+   </desc>
+  </signal>
+  <signal id="gtk.gtkstatusicon.signal.popup-menu">
+   <signalname>popup-menu</signalname>
+   <funcsynopsis>
+    <funcprototype>
+     <funcdef>void <function>callback</function></funcdef>
+     <paramdef>GtkWidget <parameter>widget</parameter></paramdef>
+    </funcprototype>
+   </funcsynopsis>
+   <shortdesc>
+    Signal emitted on a right mouse button click.
+   </shortdesc>
+   <desc>
+    <para>
+     Signal emitted on a right mouse button click.
+    </para>
+   </desc>
+  </signal>
+ </signals>
+
+</classentry>

http://cvs.php.net/viewvc.cgi/php-gtk-doc/examples/reference/gtk/gtkstatusicon/traysimple.phpw?view=markup&rev=1.1
Index: php-gtk-doc/examples/reference/gtk/gtkstatusicon/traysimple.phpw
+++ php-gtk-doc/examples/reference/gtk/gtkstatusicon/traysimple.phpw
<?php

  class TrayApplication {
   /**
    * Application Tray Menu
    *
    * @var GtkMenu
    */
   protected $_menu;
   /**
    * Application Tray Icon
    *
    * @var GtkStatusIcon
    */
   protected $_tray;
   /**
    * Application Constructor
    *
    * @param string $tooltip Tooltip to display for GtkStatusIcon object
    * @return void
    */
    public function __construct($tooltip) {
      $this->_menu = new GtkMenu();
      $this->_tray = new GtkStatusIcon();
      $this->_tray->set_tooltip($tooltip);
      $this->_tray->set_from_stock(Gtk::STOCK_EXECUTE);
      $this->_tray->connect('popup-menu', array($this, 'onMenu'));

      $quit = new GtkMenuItem('Quit');
      $quit->connect('activate', array($this, 'onQuit'));
      $this->_menu->append($quit);
      $this->_menu->show_all();

      $this->_tray->set_visible(true);
      $this->_tray->set_blinking(false);

      GtkStatusIcon::position_menu($this->_menu, $this->_tray);

      Gtk::main();
    }
    /**
     * Application Destructor
     *
     * @return void
     */
    public function __destruct() {
      Gtk::main_quit();
    }
    /**
     * Event handler for onQuit
     *
     * @return void
     */
    public function onQuit() {
      $this->__destruct();
    }
    /**
     * Event handler for onMenu
     *
     * @return void
     */
    public function onMenu() {
      $this->_menu->popup();
    }
  }

  $app = new TrayApplication('GtkStatusIcon object');

?>