diff --git a/doc/ChangeLog b/doc/ChangeLog index bcb046f8a..83f48e85b 100644 --- a/doc/ChangeLog +++ b/doc/ChangeLog @@ -1,6 +1,8 @@ 2003-05-21 Lee Mallabone * en/Gtk/*.xml: Remove some private bits of Gtk assembly. + * en/Gtk/Button.xml: Result of running the updater. + * en/Gtk/SizeGroup*.xml: First draft of docs for GtkSizeGroup. 2003-05-20 Hector E. Gomez Morales diff --git a/doc/en/Gtk/Button.xml b/doc/en/Gtk/Button.xml index 74c969e28..e50838fc0 100644 --- a/doc/en/Gtk/Button.xml +++ b/doc/en/Gtk/Button.xml @@ -44,8 +44,7 @@ The GLib type for Gtk.Button. - The GLib type for the Gtk.Button . + The GLib type for the Gtk.Button . @@ -59,14 +58,11 @@ - Gets or sets if wether the Button should use a or not. + Gets or sets if wether the Button should use a or not. Boolean value to select if the Button uses a or not. - Gets a value indicating if the Button uses a . - It's possible to create a Button from , which is recommended for consistency in Gnome + Gets a value indicating if the Button uses a . + It's possible to create a Button from , which is recommended for consistency in Gnome apps. They also provide a and a key shortcut. @@ -134,7 +130,8 @@ - launched when the button is activated. + + launched when the button is activated. @@ -144,7 +141,8 @@ - launched when the button is clicked. + + launched when the button is clicked. @@ -154,7 +152,8 @@ - launched when the cursor + + launched when the cursor leaves the button area. @@ -165,7 +164,8 @@ - launched when the button is pressed. + + launched when the button is pressed. @@ -175,7 +175,8 @@ - launched when the button is released. + + launched when the button is released. @@ -185,7 +186,8 @@ - launched when the cursor + + launched when the cursor enters the button area. @@ -354,5 +356,19 @@ shows the string passed as parameter. + + + Constructor + + + + + + To be added + To be added: an object of type 'IntPtr' + To be added: an object of type 'Gtk.Button' + To be added + + \ No newline at end of file diff --git a/doc/en/Gtk/SizeGroup.xml b/doc/en/Gtk/SizeGroup.xml index 8209d453d..7eecf8dde 100644 --- a/doc/en/Gtk/SizeGroup.xml +++ b/doc/en/Gtk/SizeGroup.xml @@ -1,5 +1,5 @@ - + gtk-sharp 0.0.0.0 @@ -7,8 +7,26 @@ Gtk# is thread aware, but not thread safe; See the Gtk# Thread Programming for details. - To be added - To be added + Group widgets so they request the same size. + + + A SizeGroup provides a mechanism for grouping a number of widgets together so they all request the same amount of space. This is typically useful when you want a column of widgets to have the same size, but you can't use a widget. Its use is effectively demonstrated by the Human Interface Guidelines of the Gnome project. + + + + In detail, the size requested for each widget in a SizeGroup is the maximum of the sizes that would have been requested for each widget in the SizeGroup without a SizeGroup. The of the size group determines whether this applies to the horizontal size, the vertical size, or both sizes. + + + + Note that SizeGroups only affect the amount of space requested, not the size that the widgets finally receive. If you want the widgets in a SizeGroup to actually be the same size, you need to pack them in such a way that they get the size they request and not more. For example, if you are packing your widgets into a table, you would not include the Fill flag. + + + SizeGroup objects are referenced by each widget in the size group, so once you have added all widgets to a SizeGroup, you can drop the initial reference to the SizeGroup by calling . If the widgets in the SizeGroup are subsequently destroyed, then they will be removed from the SizeGroup and drop their references on the SizeGroup; when all widgets have been removed, the size group will be freed. + + + Widgets can be part of multiple size groups; GTK will compute the horizontal size of a widget from the horizontal requisition of all widgets that can be reached from the widget by a chain of size groups of type or . Likewise, the vertical size is computed from the vertical requisition of all widgets that can be reached from the widget by a chain of size groups of type or . + + GLib.Object @@ -33,9 +51,9 @@ - To be added - To be added: an object of type 'Gtk.Widget' - To be added + Places a widget in this SizeGroup + A Widget whose size should be tied to widgets in a group. + @@ -48,9 +66,9 @@ - To be added - To be added: an object of type 'Gtk.Widget' - To be added + Removes a widget from this SizeGroup + A Widget whose size should no longer be tied to the widgets in this group. + @@ -89,10 +107,10 @@ - To be added - To be added: an object of type 'Gtk.SizeGroupMode' - To be added: an object of type 'Gtk.SizeGroup' - To be added + Create a new SizeGroup. + The mode to indicate direction(s) that should have their sizes tied together. + A new SizeGroup + The direction that size is tied can be altered later using the property. @@ -101,9 +119,9 @@ - To be added - To be added: an object of type 'Gtk.SizeGroup' - To be added + Internal constructor + + @@ -128,10 +146,14 @@ - To be added - To be added: an object of type 'Gtk.SizeGroupMode' - To be added: an object of type 'Gtk.SizeGroupMode' - To be added + Sets a mode to determine which direction this SizeGroup controls. + A new direction 'mode' for this SizeGroup to tie together. + The current 'mode' that indicates the direction this SizeGroup ties together. + + + The mode of the size group determines whether the widgets in the SizeGroup should all have the same or requisition, or should all have the same requisition in directions. + + diff --git a/doc/en/Gtk/SizeGroupMode.xml b/doc/en/Gtk/SizeGroupMode.xml index 5be6de0a0..edc205884 100644 --- a/doc/en/Gtk/SizeGroupMode.xml +++ b/doc/en/Gtk/SizeGroupMode.xml @@ -1,5 +1,5 @@ - + gtk-sharp 0.0.0.0 @@ -7,8 +7,8 @@ Gtk# is thread aware, but not thread safe; See the Gtk# Thread Programming for details. - To be added - To be added + Determine the direction that is affected by a . + The mode of the determines the directions in which the affects the requested sizes of its component widgets. System.Enum @@ -34,8 +34,8 @@ - To be added - To be added + Has no effect on widget size requisitions. + @@ -46,8 +46,8 @@ - To be added - To be added + Affects widget size requisitions horizontally. + @@ -58,8 +58,8 @@ - To be added - To be added + Affects widget size requisitions horizontally. + @@ -70,8 +70,8 @@ - To be added - To be added + Affects widget size requisitions both horizontally and vertically. + @@ -82,8 +82,8 @@ - To be added - To be added + +