cvs: php-gtk-doc /manual/en/reference/gtk gtkwidget.xml gtkwindow.xml

cweiske		Tue Nov 21 09:35:16 2006 UTC

  Modified files:              
    /php-gtk-doc/manual/en/reference/gtk	gtkwidget.xml gtkwindow.xml 
  Log:
  GtkWidget::render_icon() and GtkWindow::set_icon example
  and documentation
  
  
http://cvs.php.net/viewvc.cgi/php-gtk-doc/manual/en/reference/gtk/gtkwidget.xml?r1=1.30&r2=1.31&diff_format=u
Index: php-gtk-doc/manual/en/reference/gtk/gtkwidget.xml
diff -u php-gtk-doc/manual/en/reference/gtk/gtkwidget.xml:1.30 php-gtk-doc/manual/en/reference/gtk/gtkwidget.xml:1.31
--- php-gtk-doc/manual/en/reference/gtk/gtkwidget.xml:1.30	Mon Nov  6 21:43:34 2006
+++ php-gtk-doc/manual/en/reference/gtk/gtkwidget.xml	Tue Nov 21 09:35:16 2006
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- $Revision: 1.30 $ -->
+<!-- $Revision: 1.31 $ -->
 <classentry id="gtk.gtkwidget">
  <classmeta>
   <classtitle>GtkWidget</classtitle>
@@ -2087,17 +2087,23 @@
   <method id="gtk.gtkwidget.method.render_icon">
    <funcsynopsis>
     <funcprototype>
-     <funcdef> <function>render_icon</function></funcdef>
-     <paramdef>string <parameter>stock_id</parameter></paramdef>
-     <paramdef>GtkIconSize <parameter>size</parameter></paramdef>
+     <funcdef><classname>GdkPixbuf</classname> <function>render_icon</function></funcdef>
+     <paramdef><enumname>GtkStockItems</enumname> <parameter>stock_id</parameter></paramdef>
+     <paramdef><enumname>GtkIconSize</enumname> <parameter>size</parameter></paramdef>
      <paramdef>string <parameter><optional>detail = null</optional></parameter></paramdef>
     </funcprototype>
    </funcsynopsis>
    <shortdesc>
-
+    Creates a GdkPixbuf from a stock item.
    </shortdesc>
    <desc>
-
+    <para>
+     Creates a <classname>GdkPixbuf</classname> from a given
+     stock item enum and at the given <parameter>size</parameter>.
+    </para>
+    <para>
+     See <function class="GtkWindow">set_icon</function> for a usage example.
+    </para>
    </desc>
   </method>
 
http://cvs.php.net/viewvc.cgi/php-gtk-doc/manual/en/reference/gtk/gtkwindow.xml?r1=1.30&r2=1.31&diff_format=u
Index: php-gtk-doc/manual/en/reference/gtk/gtkwindow.xml
diff -u php-gtk-doc/manual/en/reference/gtk/gtkwindow.xml:1.30 php-gtk-doc/manual/en/reference/gtk/gtkwindow.xml:1.31
--- php-gtk-doc/manual/en/reference/gtk/gtkwindow.xml:1.30	Fri Oct 20 02:56:33 2006
+++ php-gtk-doc/manual/en/reference/gtk/gtkwindow.xml	Tue Nov 21 09:35:16 2006
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- $Revision: 1.30 $ -->
+<!-- $Revision: 1.31 $ -->
 <classentry id="gtk.gtkwindow">
  <classmeta>
   <classtitle>GtkWindow</classtitle>
@@ -663,9 +663,9 @@
     </para>
     <para>
      &seealso;
+     <function class="GtkWindow">get_icon</function>,
      <function class="GtkWindow">set_icon_list</function>
     </para>
-
    </desc>
   </method>
 
@@ -1801,6 +1801,24 @@
      image from the list will be used in each instance where the icon is
      shown.
     </para>
+    <example>
+     <title>Using a stock icon as window icon</title>
+     <programlisting role="php"><![CDATA[
+$wnd = new GtkWindow();
+$pixbuf = $wnd->render_icon(
+    Gtk::STOCK_FIND,
+    Gtk::ICON_SIZE_DIALOG
+);
+$wnd->set_icon($pixbuf);
+]]></programlisting>
+     <para>
+      This example uses <function class="GtkWidget">render_icon</function>
+      to create a <classname>GdkPixbuf</classname> from a
+      <enumname>GtkStockItems</enumname> enum, together with a
+      <enumname>GtkIconSize</enumname> size definition.
+     </para>
+    </example>
+
     <para>
      &seealso;
      <function class="GtkWindow">get_icon</function>,