From b70d5c0800bf97db5caa590fe6936dd44bc00a98 Mon Sep 17 00:00:00 2001
From: Duncan Mak <duncan@mono-cvs.ximian.com>
Date: Wed, 6 Aug 2003 06:11:18 +0000
Subject: [PATCH] 2003-08-06  Xavier Amado <xavier@blackbloodstudios.com>

	* /en/Gtk/Notebook.xml: documented the CurrentPageWidget property

svn path=/trunk/gtk-sharp/; revision=17105
---
 doc/ChangeLog           |   4 +
 doc/en/Gtk/Notebook.xml | 200 ++++++++++++++++++++++------------------
 2 files changed, 112 insertions(+), 92 deletions(-)

diff --git a/doc/ChangeLog b/doc/ChangeLog
index c2596ea90..22b3533c9 100644
--- a/doc/ChangeLog
+++ b/doc/ChangeLog
@@ -1,3 +1,7 @@
+2003-08-06  Xavier Amado <xavier@blackbloodstudios.com>
+
+	* /en/Gtk/Notebook.xml: documented the CurrentPageWidget property
+                                                                           
 2003-08-04  Martin Willemoes Hansen <mwh@sysrq.dk>
 	* /en/Gnome/InteractFunction.xml:
 	* /en/Gnome/ModuleClassInitHook.xml:
diff --git a/doc/en/Gtk/Notebook.xml b/doc/en/Gtk/Notebook.xml
index 0a72a2696..fd610bada 100644
--- a/doc/en/Gtk/Notebook.xml
+++ b/doc/en/Gtk/Notebook.xml
@@ -57,8 +57,8 @@
         <ReturnType>System.String</ReturnType>
       </ReturnValue>
       <Parameters>
-		<Parameter Name="child" Type="Gtk.Widget" />
-	</Parameters>
+        <Parameter Name="child" Type="Gtk.Widget" />
+      </Parameters>
       <Docs>
         <summary>Returns the label widget for a given widget.</summary>
         <param name="child">The widget in the page.</param>
@@ -80,8 +80,8 @@
         <ReturnType>System.String</ReturnType>
       </ReturnValue>
       <Parameters>
-		<Parameter Name="child" Type="Gtk.Widget" />
-	</Parameters>
+        <Parameter Name="child" Type="Gtk.Widget" />
+      </Parameters>
       <Docs>
         <summary>Returns the label caption for a given widget.</summary>
         <param name="child">The child widget in the page</param>
@@ -125,9 +125,9 @@
         <ReturnType>System.Void</ReturnType>
       </ReturnValue>
       <Parameters>
-		<Parameter Name="child" Type="Gtk.Widget" />
-		<Parameter Name="tab_text" Type="System.String" />
-	</Parameters>
+        <Parameter Name="child" Type="Gtk.Widget" />
+        <Parameter Name="tab_text" Type="System.String" />
+      </Parameters>
       <Docs>
         <summary>Sets the label for the page containing a widget</summary>
         <param name="child">The child widget whose label will be changed</param>
@@ -179,8 +179,8 @@
         <ReturnType>System.Void</ReturnType>
       </ReturnValue>
       <Parameters>
-		<Parameter Name="page_num" Type="System.Int32" />
-	</Parameters>
+        <Parameter Name="page_num" Type="System.Int32" />
+      </Parameters>
       <Docs>
         <summary>Removes a page.</summary>
         <param name="page_num">The page number to remove starting from
@@ -200,9 +200,9 @@
         <ReturnType>System.Void</ReturnType>
       </ReturnValue>
       <Parameters>
-		<Parameter Name="child" Type="Gtk.Widget" />
-		<Parameter Name="tab_label" Type="Gtk.Widget" />
-	</Parameters>
+        <Parameter Name="child" Type="Gtk.Widget" />
+        <Parameter Name="tab_label" Type="Gtk.Widget" />
+      </Parameters>
       <Docs>
         <summary>Appends a page.</summary>
         <param name="child">The <see cref="T:Gtk.Widget" /> to use as the contents of the page. </param>
@@ -220,10 +220,10 @@
         <ReturnType>System.Void</ReturnType>
       </ReturnValue>
       <Parameters>
-		<Parameter Name="child" Type="Gtk.Widget" />
-		<Parameter Name="tab_label" Type="Gtk.Widget" />
-		<Parameter Name="menu_label" Type="Gtk.Widget" />
-	</Parameters>
+        <Parameter Name="child" Type="Gtk.Widget" />
+        <Parameter Name="tab_label" Type="Gtk.Widget" />
+        <Parameter Name="menu_label" Type="Gtk.Widget" />
+      </Parameters>
       <Docs>
         <summary>Appends a page, with a custom popup-label.</summary>
         <param name="child">The <see cref="T:Gtk.Widget" /> to use as
@@ -253,10 +253,10 @@
         <ReturnType>System.Void</ReturnType>
       </ReturnValue>
       <Parameters>
-		<Parameter Name="child" Type="Gtk.Widget" />
-		<Parameter Name="tab_label" Type="Gtk.Widget" />
-		<Parameter Name="position" Type="System.Int32" />
-	</Parameters>
+        <Parameter Name="child" Type="Gtk.Widget" />
+        <Parameter Name="tab_label" Type="Gtk.Widget" />
+        <Parameter Name="position" Type="System.Int32" />
+      </Parameters>
       <Docs>
         <summary>Inserts a page into the notebook</summary>
         <param name="child">The <see cref="T:Gtk.Widget" /> to use as
@@ -284,8 +284,8 @@
         <ReturnType>Gtk.Widget</ReturnType>
       </ReturnValue>
       <Parameters>
-		<Parameter Name="child" Type="Gtk.Widget" />
-	</Parameters>
+        <Parameter Name="child" Type="Gtk.Widget" />
+      </Parameters>
       <Docs>
         <summary>To be added</summary>
         <param name="child">To be added: an object of type 'Gtk.Widget'</param>
@@ -300,9 +300,9 @@
         <ReturnType>System.Void</ReturnType>
       </ReturnValue>
       <Parameters>
-		<Parameter Name="child" Type="Gtk.Widget" />
-		<Parameter Name="position" Type="System.Int32" />
-	</Parameters>
+        <Parameter Name="child" Type="Gtk.Widget" />
+        <Parameter Name="position" Type="System.Int32" />
+      </Parameters>
       <Docs>
         <summary>Changes the position of a widget in the notebook.</summary>
         <param name="child">The widget to move.</param>
@@ -325,11 +325,11 @@
         <ReturnType>System.Void</ReturnType>
       </ReturnValue>
       <Parameters>
-		<Parameter Name="child" Type="Gtk.Widget" />
-		<Parameter Name="expand" Type="System.Boolean" />
-		<Parameter Name="fill" Type="System.Boolean" />
-		<Parameter Name="pack_type" Type="Gtk.PackType" />
-	</Parameters>
+        <Parameter Name="child" Type="Gtk.Widget" />
+        <Parameter Name="expand" Type="System.Boolean" />
+        <Parameter Name="fill" Type="System.Boolean" />
+        <Parameter Name="pack_type" Type="Gtk.PackType" />
+      </Parameters>
       <Docs>
         <summary>To be added</summary>
         <param name="child">To be added: an object of type 'Gtk.Widget'</param>
@@ -346,8 +346,8 @@
         <ReturnType>Gtk.Widget</ReturnType>
       </ReturnValue>
       <Parameters>
-		<Parameter Name="child" Type="Gtk.Widget" />
-	</Parameters>
+        <Parameter Name="child" Type="Gtk.Widget" />
+      </Parameters>
       <Docs>
         <summary>To be added</summary>
         <param name="child">To be added: an object of type 'Gtk.Widget'</param>
@@ -362,8 +362,8 @@
         <ReturnType>Gtk.Widget</ReturnType>
       </ReturnValue>
       <Parameters>
-		<Parameter Name="page_num" Type="System.Int32" />
-	</Parameters>
+        <Parameter Name="page_num" Type="System.Int32" />
+      </Parameters>
       <Docs>
         <summary>To be added</summary>
         <param name="page_num">To be added: an object of type 'int'</param>
@@ -378,9 +378,9 @@
         <ReturnType>System.Void</ReturnType>
       </ReturnValue>
       <Parameters>
-		<Parameter Name="child" Type="Gtk.Widget" />
-		<Parameter Name="menu_text" Type="System.String" />
-	</Parameters>
+        <Parameter Name="child" Type="Gtk.Widget" />
+        <Parameter Name="menu_text" Type="System.String" />
+      </Parameters>
       <Docs>
         <summary>To be added</summary>
         <param name="child">To be added: an object of type 'Gtk.Widget'</param>
@@ -395,9 +395,9 @@
         <ReturnType>System.Void</ReturnType>
       </ReturnValue>
       <Parameters>
-		<Parameter Name="child" Type="Gtk.Widget" />
-		<Parameter Name="tab_label" Type="Gtk.Widget" />
-	</Parameters>
+        <Parameter Name="child" Type="Gtk.Widget" />
+        <Parameter Name="tab_label" Type="Gtk.Widget" />
+      </Parameters>
       <Docs>
         <summary>To be added</summary>
         <param name="child">To be added: an object of type 'Gtk.Widget'</param>
@@ -424,10 +424,10 @@
         <ReturnType>System.Void</ReturnType>
       </ReturnValue>
       <Parameters>
-		<Parameter Name="child" Type="Gtk.Widget" />
-		<Parameter Name="tab_label" Type="Gtk.Widget" />
-		<Parameter Name="menu_label" Type="Gtk.Widget" />
-	</Parameters>
+        <Parameter Name="child" Type="Gtk.Widget" />
+        <Parameter Name="tab_label" Type="Gtk.Widget" />
+        <Parameter Name="menu_label" Type="Gtk.Widget" />
+      </Parameters>
       <Docs>
         <summary>To be added</summary>
         <param name="child">To be added: an object of type 'Gtk.Widget'</param>
@@ -443,9 +443,9 @@
         <ReturnType>System.Void</ReturnType>
       </ReturnValue>
       <Parameters>
-		<Parameter Name="child" Type="Gtk.Widget" />
-		<Parameter Name="menu_label" Type="Gtk.Widget" />
-	</Parameters>
+        <Parameter Name="child" Type="Gtk.Widget" />
+        <Parameter Name="menu_label" Type="Gtk.Widget" />
+      </Parameters>
       <Docs>
         <summary>To be added</summary>
         <param name="child">To be added: an object of type 'Gtk.Widget'</param>
@@ -460,11 +460,11 @@
         <ReturnType>System.Void</ReturnType>
       </ReturnValue>
       <Parameters>
-		<Parameter Name="child" Type="Gtk.Widget" />
-		<Parameter Name="expand" Type="System.Boolean" />
-		<Parameter Name="fill" Type="System.Boolean" />
-		<Parameter Name="pack_type" Type="Gtk.PackType" />
-	</Parameters>
+        <Parameter Name="child" Type="Gtk.Widget" />
+        <Parameter Name="expand" Type="System.Boolean" />
+        <Parameter Name="fill" Type="System.Boolean" />
+        <Parameter Name="pack_type" Type="Gtk.PackType" />
+      </Parameters>
       <Docs>
         <summary>To be added</summary>
         <param name="child">To be added: an object of type 'Gtk.Widget'</param>
@@ -491,8 +491,8 @@
       <MemberType>Constructor</MemberType>
       <ReturnValue />
       <Parameters>
-		<Parameter Name="raw" Type="System.IntPtr" />
-	</Parameters>
+        <Parameter Name="raw" Type="System.IntPtr" />
+      </Parameters>
       <Docs>
         <summary>Internal constructor</summary>
         <param name="raw">Pointer to the C object.</param>
@@ -531,8 +531,7 @@
       <ReturnValue>
         <ReturnType>System.Int32</ReturnType>
       </ReturnValue>
-      <Parameters>
-	</Parameters>
+      <Parameters></Parameters>
       <Docs>
         <summary>To be added</summary>
         <param name="value">To be added: an object of type 'int'</param>
@@ -546,8 +545,7 @@
       <ReturnValue>
         <ReturnType>System.Boolean</ReturnType>
       </ReturnValue>
-      <Parameters>
-	</Parameters>
+      <Parameters></Parameters>
       <Docs>
         <summary>To be added</summary>
         <param name="value">To be added: an object of type 'bool'</param>
@@ -561,8 +559,7 @@
       <ReturnValue>
         <ReturnType>System.Boolean</ReturnType>
       </ReturnValue>
-      <Parameters>
-	</Parameters>
+      <Parameters></Parameters>
       <Docs>
         <summary>To be added</summary>
         <param name="value">To be added: an object of type 'bool'</param>
@@ -576,8 +573,7 @@
       <ReturnValue>
         <ReturnType>System.Boolean</ReturnType>
       </ReturnValue>
-      <Parameters>
-	</Parameters>
+      <Parameters></Parameters>
       <Docs>
         <summary>To be added</summary>
         <param name="value">To be added: an object of type 'bool'</param>
@@ -591,8 +587,7 @@
       <ReturnValue>
         <ReturnType>System.UInt32</ReturnType>
       </ReturnValue>
-      <Parameters>
-	</Parameters>
+      <Parameters></Parameters>
       <Docs>
         <summary>To be added</summary>
         <param name="value">To be added: an object of type 'uint'</param>
@@ -606,8 +601,7 @@
       <ReturnValue>
         <ReturnType>System.Boolean</ReturnType>
       </ReturnValue>
-      <Parameters>
-	</Parameters>
+      <Parameters></Parameters>
       <Docs>
         <summary>To be added</summary>
         <param name="value">To be added: an object of type 'bool'</param>
@@ -621,8 +615,7 @@
       <ReturnValue>
         <ReturnType>System.UInt32</ReturnType>
       </ReturnValue>
-      <Parameters>
-	</Parameters>
+      <Parameters></Parameters>
       <Docs>
         <summary>To be added</summary>
         <param name="value">To be added: an object of type 'uint'</param>
@@ -636,8 +629,7 @@
       <ReturnValue>
         <ReturnType>System.UInt32</ReturnType>
       </ReturnValue>
-      <Parameters>
-	</Parameters>
+      <Parameters></Parameters>
       <Docs>
         <summary>To be added</summary>
         <param name="value">To be added: an object of type 'uint'</param>
@@ -651,8 +643,7 @@
       <ReturnValue>
         <ReturnType>System.Int32</ReturnType>
       </ReturnValue>
-      <Parameters>
-	</Parameters>
+      <Parameters></Parameters>
       <Docs>
         <summary>To be added</summary>
         <param name="value">To be added: an object of type 'int'</param>
@@ -666,8 +657,7 @@
       <ReturnValue>
         <ReturnType>Gtk.PositionType</ReturnType>
       </ReturnValue>
-      <Parameters>
-	</Parameters>
+      <Parameters></Parameters>
       <Docs>
         <summary>To be added</summary>
         <param name="value">To be added: an object of type 'Gtk.PositionType'</param>
@@ -681,8 +671,7 @@
       <ReturnValue>
         <ReturnType>System.Boolean</ReturnType>
       </ReturnValue>
-      <Parameters>
-	</Parameters>
+      <Parameters></Parameters>
       <Docs>
         <summary>To be added</summary>
         <param name="value">To be added: an object of type 'bool'</param>
@@ -693,7 +682,9 @@
     <Member MemberName="SelectPage">
       <MemberSignature Language="C#" Value="public event GtkSharp.SelectPageHandler SelectPage;" />
       <MemberType>Event</MemberType>
-      <ReturnValue><ReturnType>GtkSharp.SelectPageHandler</ReturnType></ReturnValue>
+      <ReturnValue>
+        <ReturnType>GtkSharp.SelectPageHandler</ReturnType>
+      </ReturnValue>
       <Parameters />
       <Docs>
         <summary>To be added</summary>
@@ -703,7 +694,9 @@
     <Member MemberName="SwitchPage">
       <MemberSignature Language="C#" Value="public event GtkSharp.SwitchPageHandler SwitchPage;" />
       <MemberType>Event</MemberType>
-      <ReturnValue><ReturnType>GtkSharp.SwitchPageHandler</ReturnType></ReturnValue>
+      <ReturnValue>
+        <ReturnType>GtkSharp.SwitchPageHandler</ReturnType>
+      </ReturnValue>
       <Parameters />
       <Docs>
         <summary>Signaled when the page changes</summary>
@@ -718,7 +711,9 @@
     <Member MemberName="MoveFocusOut">
       <MemberSignature Language="C#" Value="public event GtkSharp.MoveFocusOutHandler MoveFocusOut;" />
       <MemberType>Event</MemberType>
-      <ReturnValue><ReturnType>GtkSharp.MoveFocusOutHandler</ReturnType></ReturnValue>
+      <ReturnValue>
+        <ReturnType>GtkSharp.MoveFocusOutHandler</ReturnType>
+      </ReturnValue>
       <Parameters />
       <Docs>
         <summary>Signaled when Focus is being moved out.</summary>
@@ -733,7 +728,9 @@
     <Member MemberName="ChangeCurrentPage">
       <MemberSignature Language="C#" Value="public event GtkSharp.ChangeCurrentPageHandler ChangeCurrentPage;" />
       <MemberType>Event</MemberType>
-      <ReturnValue><ReturnType>GtkSharp.ChangeCurrentPageHandler</ReturnType></ReturnValue>
+      <ReturnValue>
+        <ReturnType>GtkSharp.ChangeCurrentPageHandler</ReturnType>
+      </ReturnValue>
       <Parameters />
       <Docs>
         <summary>Signaled when a request is made to change the current
@@ -749,7 +746,9 @@
     <Member MemberName="FocusTab">
       <MemberSignature Language="C#" Value="public event GtkSharp.FocusTabHandler FocusTab;" />
       <MemberType>Event</MemberType>
-      <ReturnValue><ReturnType>GtkSharp.FocusTabHandler</ReturnType></ReturnValue>
+      <ReturnValue>
+        <ReturnType>GtkSharp.FocusTabHandler</ReturnType>
+      </ReturnValue>
       <Parameters />
       <Docs>
         <summary>Signaled when a Tab is focused</summary>
@@ -767,11 +766,11 @@
         <ReturnType>System.Void</ReturnType>
       </ReturnValue>
       <Parameters>
-		<Parameter Name="child" Type="Gtk.Widget" />
-		<Parameter Name="tab_label" Type="Gtk.Widget" />
-		<Parameter Name="menu_label" Type="Gtk.Widget" />
-		<Parameter Name="position" Type="System.Int32" />
-	</Parameters>
+        <Parameter Name="child" Type="Gtk.Widget" />
+        <Parameter Name="tab_label" Type="Gtk.Widget" />
+        <Parameter Name="menu_label" Type="Gtk.Widget" />
+        <Parameter Name="position" Type="System.Int32" />
+      </Parameters>
       <Docs>
         <summary>To be added</summary>
         <param name="child">To be added: an object of type 'Gtk.Widget'</param>
@@ -788,9 +787,9 @@
         <ReturnType>System.Void</ReturnType>
       </ReturnValue>
       <Parameters>
-		<Parameter Name="child" Type="Gtk.Widget" />
-		<Parameter Name="tab_label" Type="Gtk.Widget" />
-	</Parameters>
+        <Parameter Name="child" Type="Gtk.Widget" />
+        <Parameter Name="tab_label" Type="Gtk.Widget" />
+      </Parameters>
       <Docs>
         <summary>To be added</summary>
         <param name="child">To be added: an object of type 'Gtk.Widget'</param>
@@ -803,8 +802,8 @@
       <MemberType>Constructor</MemberType>
       <ReturnValue />
       <Parameters>
-		<Parameter Name="gtype" Type="GLib.Type" />
-	</Parameters>
+        <Parameter Name="gtype" Type="GLib.Type" />
+      </Parameters>
       <Docs>
         <summary>Internal constructor</summary>
         <param name="gtype">GLib type for the type</param>
@@ -826,5 +825,22 @@
         <remarks>To be added</remarks>
       </Docs>
     </Member>
+    <Member MemberName="CurrentPageWidget">
+      <MemberSignature Language="C#" Value="public Gtk.Widget CurrentPageWidget { get; };" />
+      <MemberType>Property</MemberType>
+      <ReturnValue>
+        <ReturnType>Gtk.Widget</ReturnType>
+      </ReturnValue>
+      <Docs>
+        <summary>Obtains the widget that represents the current page.</summary>
+        <returns>The Gtk.Widget object in the current page.</returns>
+        <remarks>
+          <para>
+            This property uses <see cref="P:Gtk.Notebook.CurrentPage" /> and <see cref="M:Gtk.Notebook.GetNthPage" /> together to
+            provide a quicker way of getting the current page widget.
+          </para>
+        </remarks>
+      </Docs>
+    </Member>
   </Members>
-</Type>
+</Type>
\ No newline at end of file