GtkSharp/doc/en/Gtk/Container.xml
Mike Kestner f8d36b9453 2005-05-23 Mike Kestner <mkestner@novell.com>
* configure.in.in : add monodocer-fu.

2005-05-23  Mike Kestner  <mkestner@novell.com>

	* Makefile.am : switch to monodocer
	* updater : kill
	* en/*/*.xml : enormo-diff from monodocer first run without --delete.

svn path=/trunk/gtk-sharp/; revision=44915
2005-05-23 20:41:51 +00:00

751 lines
34 KiB
XML

<Type Name="Container" FullName="Gtk.Container">
<TypeSignature Language="C#" Maintainer="John Luke" Value="public class Container : Gtk.Widget, System.Collections.IEnumerable" />
<AssemblyInfo>
<AssemblyName>gtk-sharp</AssemblyName>
<AssemblyPublicKey>
</AssemblyPublicKey>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
</AssemblyInfo>
<ThreadSafetyStatement>Gtk# is thread aware, but not thread safe; See the <link location="node:gtk-sharp/programming/threads">Gtk# Thread Programming</link> for details.</ThreadSafetyStatement>
<Docs>
<summary>Base class for widgets which contain other widgets</summary>
<remarks>
<para>
A Gtk# user interface is constructed by nesting widgets inside widgets. <see cref="T:Gtk.Container" /> widgets are the inner nodes in the resulting tree of widgets: they contain other widgets. So, for example, you might have a <see cref="T:Gtk.Window" /> containing a <see cref="T:Gtk.Frame" /> containing a <see cref="T:Gtk.Label" />. If you wanted an image instead of a textual label inside the frame, you might replace the <see cref="T:Gtk.Label" /> widget with a <see cref="T:Gtk.Image" /> widget.
</para>
<para>
There are two major kinds of <see cref="T:Gtk.Container" /> widgets in Gtk#. Both are subclasses of the abstract <see cref="T:Gtk.Container" /> base class.
</para>
<para>
The first type of <see cref="T:Gtk.Container" /> widget has a single child widget and derives from <see cref="T:Gtk.Bin" />. These containers are decorators, which add some kind of functionality to the child. For example, a <see cref="T:Gtk.Button" /> makes its child into a clickable button; a <see cref="T:Gtk.Frame" /> draws a frame around its child and a <see cref="T:Gtk.Window" /> places its child widget inside a top-level <see cref="T:Gtk.Window" />.
</para>
<para>
The second type of <see cref="T:Gtk.Container" /> can have more than one child; its purpose is to manage layout. This means that these containers assign sizes and positions to their children. For example, a <see cref="T:Gtk.HBox" /> arranges its children in a horizontal row, and a <see cref="T:Gtk.Table" /> arranges the widgets it contains in a two-dimensional grid.
</para>
<para>
To fulfill its task, a layout <see cref="T:Gtk.Container" /> must negotiate the size requirements with its parent and its children. This negotiation is carried out in two phases, size requisition and size allocation.
</para>
</remarks>
</Docs>
<Base>
<BaseTypeName>Gtk.Widget</BaseTypeName>
</Base>
<Interfaces>
<Interface>
<InterfaceName>System.Collections.IEnumerable</InterfaceName>
</Interface>
</Interfaces>
<Attributes>
<Attribute>
<AttributeName>System.Reflection.DefaultMember(MemberName="Item")</AttributeName>
</Attribute>
</Attributes>
<Members>
<Member MemberName="CheckResize">
<MemberSignature Language="C#" Value="public void CheckResize ();" />
<MemberType>Method</MemberType>
<ReturnValue>
<ReturnType>System.Void</ReturnType>
</ReturnValue>
<Parameters />
<Docs>
<summary>Attempts to resize this container.</summary>
<remarks />
</Docs>
</Member>
<Member MemberName="ChildGetValist">
<MemberSignature Language="C#" Value="public void ChildGetValist (Gtk.Widget child, string first_property_name, IntPtr var_args);" />
<MemberType>Method</MemberType>
<ReturnValue>
<ReturnType>System.Void</ReturnType>
</ReturnValue>
<Parameters>
<Parameter Name="child" Type="Gtk.Widget" />
<Parameter Name="first_property_name" Type="System.String" />
<Parameter Name="var_args" Type="System.IntPtr" />
</Parameters>
<Docs>
<summary>Gets the values of one or more child properties for child and container.</summary>
<param name="child">an object of type <see cref="T:Gtk.Widget" /></param>
<param name="first_property_name">an object of type <see cref="T:System.String" /></param>
<param name="var_args">an object of type <see cref="T:System.IntPtr" /></param>
<remarks>Gets the values of one or more child properties for child and container.</remarks>
</Docs>
</Member>
<Member MemberName="Add">
<MemberSignature Language="C#" Value="public void Add (Gtk.Widget widget);" />
<MemberType>Method</MemberType>
<ReturnValue>
<ReturnType>System.Void</ReturnType>
</ReturnValue>
<Parameters>
<Parameter Name="widget" Type="Gtk.Widget" />
</Parameters>
<Docs>
<summary>Adds a <see cref="T:Gtk.Widget" /> to the <see cref="T:Gtk.Container" />.</summary>
<param name="widget">an object of type <see cref="T:Gtk.Widget" /></param>
<remarks>
<para>
Typically used for simple containers such as <see cref="T:Gtk.Window" />, <see cref="T:Gtk.Frame" />, or <see cref="T:Gtk.Button" />; for more complicated layout containers such as <see cref="T:Gtk.Box" /> or <see cref="T:Gtk.Table" />, this function will pick default packing parameters that may not be correct. So consider functions such as <see cref="M:Gtk.Box.Packstart" /> and <see cref="M:Gtk.Table.Attach" /> as an alternative to <see cref="M:Gtk.Container.Add" /> in those cases. A <see cref="T:Gtk.Widget" /> may be added to only one <see cref="T:Gtk.Container" /> at a time; you can not place the same widget inside two different containers.
</para>
</remarks>
</Docs>
</Member>
<Member MemberName="Remove">
<MemberSignature Language="C#" Value="public void Remove (Gtk.Widget widget);" />
<MemberType>Method</MemberType>
<ReturnValue>
<ReturnType>System.Void</ReturnType>
</ReturnValue>
<Parameters>
<Parameter Name="widget" Type="Gtk.Widget" />
</Parameters>
<Docs>
<summary>Removes a <see cref="T:Gtk.Widget" /> from the <see cref="T:Gtk.Container" />.</summary>
<param name="widget">an object of type <see cref="T:Gtk.Widget" /></param>
<remarks>
<see cref="T:Gtk.Widget" /> must be inside <see cref="T:Gtk.Container" />.
</remarks>
</Docs>
</Member>
<Member MemberName="UnsetFocusChain">
<MemberSignature Language="C#" Value="public void UnsetFocusChain ();" />
<MemberType>Method</MemberType>
<ReturnValue>
<ReturnType>System.Void</ReturnType>
</ReturnValue>
<Parameters />
<Docs>
<summary>Removes a focus chain.</summary>
<remarks>Removes a focus chain explicitly set with <see cref="M:Gtk.Container.SetFocusChain(GLib.List)" />.</remarks>
</Docs>
</Member>
<Member MemberName="ResizeChildren">
<MemberSignature Language="C#" Value="public void ResizeChildren ();" />
<MemberType>Method</MemberType>
<ReturnValue>
<ReturnType>System.Void</ReturnType>
</ReturnValue>
<Parameters />
<Docs>
<summary>Tries to resize the child widgets of this container.</summary>
<remarks />
</Docs>
</Member>
<Member MemberName="ChildSetProperty">
<MemberSignature Language="C#" Value="public void ChildSetProperty (Gtk.Widget child, string property_name, GLib.Value value);" />
<MemberType>Method</MemberType>
<ReturnValue>
<ReturnType>System.Void</ReturnType>
</ReturnValue>
<Parameters>
<Parameter Name="child" Type="Gtk.Widget" />
<Parameter Name="property_name" Type="System.String" />
<Parameter Name="value" Type="GLib.Value" />
</Parameters>
<Docs>
<summary>Sets a child property of a <see cref="T:Gtk.Widget" />.</summary>
<param name="child">a child of this <see cref="T:Gtk.Container" /></param>
<param name="property_name">the child property name</param>
<param name="value">the value to set <paramref name="property_name" /> to</param>
<remarks>You will not normally need to use this method; Gtk# automatically generates child property accessors for all <see cref="T:Gtk.Container" /> subclasses.</remarks>
</Docs>
</Member>
<Member MemberName="ChildGetProperty">
<MemberSignature Language="C#" Value="public GLib.Value ChildGetProperty (Gtk.Widget child, string property_name);" />
<MemberType>Method</MemberType>
<ReturnValue>
<ReturnType>GLib.Value</ReturnType>
</ReturnValue>
<Parameters>
<Parameter Name="child" Type="Gtk.Widget" />
<Parameter Name="property_name" Type="System.String" />
</Parameters>
<Docs>
<summary>Gets a child property of a <see cref="T:Gtk.Widget" />.</summary>
<param name="child">a child of this <see cref="T:Gtk.Container" /></param>
<param name="property_name">the child property name</param>
<param name="value">the value of the <paramref name="property_name" /> property of <paramref name="child" /></param>
<remarks>You will not normally need to use this method; Gtk# automatically generates child property accessors for all <see cref="T:Gtk.Container" /> subclasses.</remarks>
<returns>To be added.</returns>
</Docs>
</Member>
<Member MemberName="PropagateExpose">
<MemberSignature Language="C#" Value="public void PropagateExpose (Gtk.Widget child, Gdk.EventExpose evnt);" />
<MemberType>Method</MemberType>
<ReturnValue>
<ReturnType>System.Void</ReturnType>
</ReturnValue>
<Parameters>
<Parameter Name="child" Type="Gtk.Widget" />
<Parameter Name="evnt" Type="Gdk.EventExpose" />
</Parameters>
<Docs>
<summary>Send synthetic expose events to all children that do not have their own <see cref="T:Gdk.Windows" />.</summary>
<param name="child">an object of type <see cref="T:Gtk.Widget" /></param>
<param name="evnt">an object of type <see cref="T:Gdk.EventExpose" /></param>
<remarks>
<para>
When a <see cref="T:Gtk.Container" /> receives an expose event, it must send synthetic expose events to all children that do not have their own <see cref="T:Gdk.Window" />s. This function provides a convenient way of doing this. A <see cref="T:Gtk.Container" />, when it receives an expose event, calls <see cref="M:Gtk.Container.PropagateExpose(Gtk.Widget,Gdk.EventExpose)" /> once for each child, passing in the event the <see cref="T:Gtk.Container" /> received.
</para>
<para>
<see cref="M:Gtk.Container.PropagateExpose(Gtk.Widget,Gdk.EventExpose)" /> takes care of deciding whether an expose event needs to be sent to the child, intersecting the event's area with the child area, and sending the event.
</para>
<para>
In most cases, a <see cref="T:Gtk.Container" /> can either simply inherit the expose implementation from <see cref="T:Gtk.Container" />, or do some drawing and then chain to the expose implementation from <see cref="T:Gtk.Container" />.
</para>
</remarks>
</Docs>
</Member>
<Member MemberName="ChildSetValist">
<MemberSignature Language="C#" Value="public void ChildSetValist (Gtk.Widget child, string first_property_name, IntPtr var_args);" />
<MemberType>Method</MemberType>
<ReturnValue>
<ReturnType>System.Void</ReturnType>
</ReturnValue>
<Parameters>
<Parameter Name="child" Type="Gtk.Widget" />
<Parameter Name="first_property_name" Type="System.String" />
<Parameter Name="var_args" Type="System.IntPtr" />
</Parameters>
<Docs>
<summary>Sets one or more child properties for child and <see cref="T:Gtk.Container" />.</summary>
<param name="child">an object of type <see cref="T:Gtk.Widget" /></param>
<param name="first_property_name">an object of type <see cref="T:System.String" /></param>
<param name="var_args">an object of type <see cref="T:System.IntPtr" /></param>
<remarks>Sets one or more child properties for child and <see cref="T:Gtk.Container" />.</remarks>
</Docs>
</Member>
<Member MemberName="Finalize">
<MemberSignature Language="C#" Value="protected override void Finalize ();" />
<MemberType>Method</MemberType>
<ReturnValue>
<ReturnType>System.Void</ReturnType>
</ReturnValue>
<Parameters />
<Docs>
<summary>Disposes the resources associated with the object.</summary>
<remarks />
</Docs>
</Member>
<Member MemberName=".ctor">
<MemberSignature Language="C#" Value="public Container (IntPtr raw);" />
<MemberType>Constructor</MemberType>
<ReturnValue />
<Parameters>
<Parameter Name="raw" Type="System.IntPtr" />
</Parameters>
<Docs>
<summary>Internal constructor</summary>
<param name="raw">Pointer to the C object.</param>
<remarks>
<para>This is an internal constructor, and should not be used by user code.</para>
</remarks>
</Docs>
</Member>
<Member MemberName="FocusVadjustment">
<MemberSignature Language="C#" Value="public Gtk.Adjustment FocusVadjustment { set; get; };" />
<MemberType>Property</MemberType>
<ReturnValue>
<ReturnType>Gtk.Adjustment</ReturnType>
</ReturnValue>
<Parameters>
</Parameters>
<Docs>
<summary>The vertical focus adjustment.</summary>
<param name="value">an object of type <see cref="T:Gtk.Adjustment" /></param>
<value>an object of type <see cref="T:Gtk.Adjustment" /></value>
<remarks />
</Docs>
</Member>
<Member MemberName="FocusHadjustment">
<MemberSignature Language="C#" Value="public Gtk.Adjustment FocusHadjustment { set; get; };" />
<MemberType>Property</MemberType>
<ReturnValue>
<ReturnType>Gtk.Adjustment</ReturnType>
</ReturnValue>
<Parameters>
</Parameters>
<Docs>
<summary>The horizontal focus adjustment.</summary>
<param name="value">an object of type <see cref="T:Gtk.Adjustment" /></param>
<value>an object of type <see cref="T:Gtk.Adjustment" /></value>
<remarks />
</Docs>
</Member>
<Member MemberName="FocusChild">
<MemberSignature Language="C#" Value="public Gtk.Widget FocusChild { set; get; };" />
<MemberType>Property</MemberType>
<ReturnValue>
<ReturnType>Gtk.Widget</ReturnType>
</ReturnValue>
<Parameters>
</Parameters>
<Docs>
<summary>Moves the focus to a particular child widget or finds the last-focused widget.</summary>
<param name="value">A <see cref="T:Gtk.Widget" />, a child of this container.</param>
<value>an object of type <see cref="T:Gtk.Widget" /></value>
<remarks />
</Docs>
</Member>
<Member MemberName="ReallocateRedraws">
<MemberSignature Language="C#" Value="public bool ReallocateRedraws { set; };" />
<MemberType>Property</MemberType>
<ReturnValue>
<ReturnType>System.Boolean</ReturnType>
</ReturnValue>
<Parameters>
</Parameters>
<Docs>
<summary>The redraw-reallocation flag. Containers requesting
reallocation redraws get automatically redrawn if any of their
children changed allocation. </summary>
<param name="value">an object of type <see cref="T:System.Boolean" /></param>
<value>an object of type <see cref="T:System.Boolean" /></value>
<remarks />
</Docs>
</Member>
<Member MemberName="Child">
<MemberSignature Language="C#" Value="public Gtk.Widget Child { set; };" />
<MemberType>Property</MemberType>
<ReturnValue>
<ReturnType>Gtk.Widget</ReturnType>
</ReturnValue>
<Parameters>
</Parameters>
<Docs>
<summary>A child widget for this container.</summary>
<param name="value">an object of type <see cref="T:Gtk.Widget" /></param>
<value>an object of type <see cref="T:Gtk.Widget" /></value>
<remarks />
</Docs>
<Attributes>
<Attribute>
<AttributeName>GLib.Property(Name="child")</AttributeName>
</Attribute>
</Attributes></Member>
<Member MemberName="ResizeMode">
<MemberSignature Language="C#" Value="public Gtk.ResizeMode ResizeMode { set; get; };" />
<MemberType>Property</MemberType>
<ReturnValue>
<ReturnType>Gtk.ResizeMode</ReturnType>
</ReturnValue>
<Parameters>
</Parameters>
<Docs>
<summary>How this container behaves when resized.</summary>
<param name="value">an object of type <see cref="T:Gtk.ResizeMode" /></param>
<value>an object of type <see cref="T:Gtk.ResizeMode" /></value>
<remarks />
</Docs>
<Attributes>
<Attribute>
<AttributeName>GLib.Property(Name="resize_mode")</AttributeName>
</Attribute>
</Attributes></Member>
<Member MemberName="BorderWidth">
<MemberSignature Language="C#" Value="public uint BorderWidth { set; get; };" />
<MemberType>Property</MemberType>
<ReturnValue>
<ReturnType>System.UInt32</ReturnType>
</ReturnValue>
<Parameters>
</Parameters>
<Docs>
<summary>This container's border width.</summary>
<param name="value">A <see cref="T:System.UInt32" /></param>
<value>A <see cref="T:System.UInt32" /></value>
<remarks />
</Docs>
<Attributes>
<Attribute>
<AttributeName>GLib.Property(Name="border_width")</AttributeName>
</Attribute>
</Attributes></Member>
<Member MemberName="Added">
<MemberSignature Language="C#" Value="public event Gtk.AddedHandler Added;" />
<MemberType>Event</MemberType>
<ReturnValue>
<ReturnType>Gtk.AddedHandler</ReturnType>
</ReturnValue>
<Parameters />
<Docs>
<summary>Fired when a child widget is added to the container via <see cref="M:Gtk.Container.Add" />.</summary>
<remarks>Note that this event is fired only when <see cref="M:Gtk.Container.Add" /> (or its C equivalent) is called. It is not a generic widget-added notification. For example, calling <see cref="M:Gtk.Box.PackStart" /> will not result in this event firing.</remarks>
</Docs>
<Attributes>
<Attribute>
<AttributeName>GLib.Signal(CName="add")</AttributeName>
</Attribute>
</Attributes></Member>
<Member MemberName="FocusChildSet">
<MemberSignature Language="C#" Value="public event Gtk.FocusChildSetHandler FocusChildSet;" />
<MemberType>Event</MemberType>
<ReturnValue>
<ReturnType>Gtk.FocusChildSetHandler</ReturnType>
</ReturnValue>
<Parameters />
<Docs>
<summary>Fired when the focus moves to a child widget of this container.</summary>
<remarks />
</Docs>
<Attributes>
<Attribute>
<AttributeName>GLib.Signal(CName="set-focus-child")</AttributeName>
</Attribute>
</Attributes></Member>
<Member MemberName="Removed">
<MemberSignature Language="C#" Value="public event Gtk.RemovedHandler Removed;" />
<MemberType>Event</MemberType>
<ReturnValue>
<ReturnType>Gtk.RemovedHandler</ReturnType>
</ReturnValue>
<Parameters />
<Docs>
<summary>Fired when a child widget is removed from this container</summary>
<remarks>Note that this event is fired only when <see cref="M:Gtk.Container.Remove" /> (or its C equivalent) is called. If a <see cref="T:Gtk.Container" /> subclass defines additional methods for removing widgets, then calling those methods will not result in this event being fired.</remarks>
</Docs>
<Attributes>
<Attribute>
<AttributeName>GLib.Signal(CName="remove")</AttributeName>
</Attribute>
</Attributes></Member>
<Member MemberName="ResizeChecked">
<MemberSignature Language="C#" Value="public event EventHandler ResizeChecked;" />
<MemberType>Event</MemberType>
<ReturnValue>
<ReturnType>System.EventHandler</ReturnType>
</ReturnValue>
<Parameters />
<Docs>
<summary>Fired when this container's resizability is queried.</summary>
<remarks />
</Docs>
<Attributes>
<Attribute>
<AttributeName>GLib.Signal(CName="check_resize")</AttributeName>
</Attribute>
</Attributes></Member>
<Member MemberName="GType">
<MemberSignature Language="C#" Value="public static GLib.GType GType { get; };" />
<MemberType>Property</MemberType>
<ReturnValue>
<ReturnType>GLib.GType</ReturnType>
</ReturnValue>
<Parameters />
<Docs>
<summary>GType Property.</summary>
<value>a <see cref="T:GLib.GType" /></value>
<remarks>Returns the native <see cref="T:GLib.GType" /> value for <see cref="T:Gtk.Container" />.</remarks>
</Docs>
</Member>
<Member MemberName="OnResizeChecked">
<MemberSignature Language="C#" Value="protected virtual void OnResizeChecked ();" />
<MemberType>Method</MemberType>
<ReturnValue>
<ReturnType>System.Void</ReturnType>
</ReturnValue>
<Parameters />
<Docs>
<summary>Default handler for the <see cref="M:Gtk.Container.ResizeChecked" /> event.</summary>
<remarks>Override this method in a subclass to provide a default handler for the <see cref="M:Gtk.Container.ResizeChecked" /> event.</remarks>
</Docs>
</Member>
<Member MemberName="OnRemoved">
<MemberSignature Language="C#" Value="protected virtual void OnRemoved (Gtk.Widget widget);" />
<MemberType>Method</MemberType>
<ReturnValue>
<ReturnType>System.Void</ReturnType>
</ReturnValue>
<Parameters>
<Parameter Name="widget" Type="Gtk.Widget" />
</Parameters>
<Docs>
<summary>Default handler for the <see cref="M:Gtk.Container.Removed" /> event.</summary>
<param name="widget">a <see cref="T:Gtk.Widget" /></param>
<remarks>Override this method in a subclass to provide a default handler for the <see cref="M:Gtk.Container.Removed" /> event.</remarks>
</Docs>
</Member>
<Member MemberName="OnFocusChildSet">
<MemberSignature Language="C#" Value="protected virtual void OnFocusChildSet (Gtk.Widget widget);" />
<MemberType>Method</MemberType>
<ReturnValue>
<ReturnType>System.Void</ReturnType>
</ReturnValue>
<Parameters>
<Parameter Name="widget" Type="Gtk.Widget" />
</Parameters>
<Docs>
<summary>Default handler for the <see cref="M:Gtk.Container.FocusChildSet" /> event.</summary>
<param name="widget">a <see cref="T:Gtk.Widget" /></param>
<remarks>Override this method in a subclass to provide a default handler for the <see cref="M:Gtk.Container.FocusChildSet" /> event.</remarks>
</Docs>
</Member>
<Member MemberName="OnAdded">
<MemberSignature Language="C#" Value="protected virtual void OnAdded (Gtk.Widget widget);" />
<MemberType>Method</MemberType>
<ReturnValue>
<ReturnType>System.Void</ReturnType>
</ReturnValue>
<Parameters>
<Parameter Name="widget" Type="Gtk.Widget" />
</Parameters>
<Docs>
<summary>Default handler for the <see cref="M:Gtk.Container.Added" /> event.</summary>
<param name="widget">a <see cref="T:Gtk.Widget" /></param>
<remarks>Override this method in a subclass to provide a default handler for the <see cref="M:Gtk.Container.Added" /> event.</remarks>
</Docs>
</Member>
<Member MemberName="Forall">
<MemberSignature Language="C#" Value="public void Forall (Gtk.Callback cb);" />
<MemberType>Method</MemberType>
<ReturnValue>
<ReturnType>System.Void</ReturnType>
</ReturnValue>
<Parameters>
<Parameter Name="cb" Type="Gtk.Callback" />
</Parameters>
<Docs>
<summary>Invokes a callback function on each child of this container,
including children that are considered "internal" (implementation
details of the container). "Internal" children generally weren't
added by the user of the container but were added by the container
implementation itself. </summary>
<param name="cb">a <see cref="T:Gtk.Callback" /></param>
<remarks>Most applications should use <see cref="M:Gtk.Container.Foreach" /> instead of this method.</remarks>
</Docs>
</Member>
<Member MemberName="Foreach">
<MemberSignature Language="C#" Value="public void Foreach (Gtk.Callback cb);" />
<MemberType>Method</MemberType>
<ReturnValue>
<ReturnType>System.Void</ReturnType>
</ReturnValue>
<Parameters>
<Parameter Name="cb" Type="Gtk.Callback" />
</Parameters>
<Docs>
<summary>Invokes a callback function on each non-internal child of this container. See <see cref="M:Gtk.Container.Forall" /> for more details on internal children. </summary>
<param name="cb">a <see cref="T:Gtk.Callback" /></param>
<remarks>Most applications should use this method instead of <see cref="M:Gtk.Container.Forall" />.
</remarks>
</Docs>
</Member>
<Member MemberName=".ctor">
<MemberSignature Language="C#" Value="protected Container (GLib.GType gtype);" />
<MemberType>Constructor</MemberType>
<ReturnValue />
<Parameters>
<Parameter Name="gtype" Type="GLib.GType" />
</Parameters>
<Docs>
<summary>Protected Constructor.</summary>
<param name="gtype">a <see cref="T:GLib.GType" /></param>
<remarks>Chain to this constructor if you have manually registered a native <see cref="T:GLib.GType" /> value for your subclass.</remarks>
</Docs>
<Attributes>
<Attribute>
<AttributeName>System.Obsolete(Message=null, IsError=False)</AttributeName>
</Attribute>
</Attributes></Member>
<Member MemberName="Children">
<MemberSignature Language="C#" Value="public Gtk.Widget[] Children { get; };" />
<MemberType>Property</MemberType>
<ReturnValue>
<ReturnType>Gtk.Widget[]</ReturnType>
</ReturnValue>
<Parameters />
<Docs>
<summary>Obtains an array of the container's (non-internal) children.</summary>
<value>An array of non-internal children.</value>
<remarks>
<para>
Returns the container's non-internal children; that is, generally, the
children that were explicitly added to the container by the application, as
opposed to those widgets that are internal implementation details of the
container.
</para>
<para>
If you simply want to do a <see langword="foreach" /> loop on the
container's children, you do not need to use the Children property.
Just do:
</para>
<example>
<code lang="C#">
foreach (Widget w in myContainer) {
// Do something with w
}
</code>
</example>
</remarks>
</Docs>
</Member>
<Member MemberName="GetEnumerator">
<MemberSignature Language="C#" Value="public System.Collections.IEnumerator GetEnumerator ();" />
<MemberType>Method</MemberType>
<ReturnValue>
<ReturnType>System.Collections.IEnumerator</ReturnType>
</ReturnValue>
<Parameters />
<Docs>
<summary>Returns an <see cref="T:System.Collections.IEnumerator" /> for the container's children</summary>
<returns>a <see cref="T:System.Collections.IEnumerator" /></returns>
<remarks>
<para>
<see cref="T:Gtk.Container" /> implements
<see cref="T:System.Collections.IEnumerable" />, so you can iterate
through its children like this:
</para>
<example>
<code lang="C#">
foreach (Widget w in myContainer) {
// Do something with w
}
</code>
</example>
</remarks>
</Docs>
</Member>
<Member MemberName="AllChildren">
<MemberSignature Language="C#" Value="public System.Collections.IEnumerable AllChildren { get; };" />
<MemberType>Property</MemberType>
<ReturnValue>
<ReturnType>System.Collections.IEnumerable</ReturnType>
</ReturnValue>
<Parameters />
<Docs>
<summary>Allows you to enumerate all of the container's children.</summary>
<value>an <see cref="T:System.Collections.IEnumerable" /></value>
<remarks>
Enumerates all of the container's children, including those widgets that are
internal implementation details of the container.
</remarks>
</Docs>
</Member>
<Member MemberName="FocusChain">
<MemberSignature Language="C#" Value="public Gtk.Widget[] FocusChain { set; get; };" />
<MemberType>Property</MemberType>
<ReturnValue>
<ReturnType>Gtk.Widget[]</ReturnType>
</ReturnValue>
<Parameters />
<Docs>
<summary>Sets or obtains a focus chain of the container, overriding the one computed automatically by Gtk#.</summary>
<value>An array of <paramref name="widgets" />.</value>
<remarks>
<para>
In principle each <see cref="T:Gtk.Widget" /> in the chain should be a descendant of the <see cref="T:Gtk.Container" />, but this is not enforced by this method, since it is allowed to set the focus chain before you pack the widgets, or have a widget in the chain that is not always packed. The necessary checks are done when the focus chain is actually traversed.
</para>
<para>
If no focus chain has been explicitly set, gtk# computes the focus chain based on the positions of the children. in that case, gtk# stores <see langword="null" /> in focusable_widgets and returns <see langword="false" />.
</para>
</remarks>
</Docs>
</Member>
<Member MemberName=".ctor">
<MemberSignature Language="C#" Value="protected Container ();" />
<MemberType>Constructor</MemberType>
<ReturnValue />
<Parameters />
<Docs>
<summary>Protected constructor for chaining by descendant classes.</summary>
<remarks>
</remarks>
</Docs>
</Member>
<Member MemberName="ForAll" Deprecated="true">
<MemberSignature Language="C#" Value="protected virtual void ForAll (bool include_internals, Gtk.Container+CallbackInvoker invoker);" />
<MemberType>Method</MemberType>
<ReturnValue>
<ReturnType>System.Void</ReturnType>
</ReturnValue>
<Parameters>
<Parameter Name="include_internals" Type="System.Boolean" />
<Parameter Name="invoker" Type="Gtk.Container+CallbackInvoker" />
</Parameters>
<Docs>
<summary>Run a given callback for every object inside this container.</summary>
<param name="include_internals">a <see cref="T:System.Boolean" />, whether to include "internal" children when running the callback.</param>
<param name="invoker">a <see cref="T:Gtk.Container+CallbackInvoker" /></param>
<remarks>
Deprecated: overload <see cref="M:Gtk.Container.Forall(System.Boolean,Gtk.Callback)" /> instead.
</remarks>
</Docs>
</Member>
<Member MemberName="ForAll">
<MemberSignature Language="C#" Value="protected virtual void ForAll (bool include_internals, Gtk.Callback callback);" />
<MemberType>Method</MemberType>
<ReturnValue>
<ReturnType>System.Void</ReturnType>
</ReturnValue>
<Parameters>
<Parameter Name="include_internals" Type="System.Boolean" />
<Parameter Name="callback" Type="Gtk.Callback" />
</Parameters>
<Docs>
<summary>Run a given callback for every object inside this container.</summary>
<param name="include_internals">a <see cref="T:System.Boolean" />, whether to include "internal" children when running the callback.</param>
<param name="callback">a <see cref="T:Gtk.Callback" /></param>
<remarks>
Overload this in subclasses of Gtk.Container to implement the
<see cref="M:Gtk.Container.Foreach" /> and <see cref="M:Gtk.Container.Forall" />
methods.
</remarks>
</Docs>
</Member>
<Member MemberName="ChildType">
<MemberSignature Language="C#" Value="public virtual GLib.GType ChildType ();" />
<MemberType>Method</MemberType>
<ReturnValue>
<ReturnType>GLib.GType</ReturnType>
</ReturnValue>
<Parameters />
<Docs>
<summary>Returns the type of children supported by this container.</summary>
<returns>a <see cref="T:GLib.GType" /></returns>
<remarks>
If you override this in a derived container class, you
must not call base.ChildType() from the overridden method.
</remarks>
</Docs>
</Member>
<Member MemberName="ForeachFull">
<MemberSignature Language="C#" Value="public void ForeachFull (Gtk.Callback cb, Gtk.CallbackMarshal marshal, IntPtr callback_data, Gtk.DestroyNotify notify);" />
<MemberType>Method</MemberType>
<ReturnValue>
<ReturnType>System.Void</ReturnType>
</ReturnValue>
<Parameters>
<Parameter Name="cb" Type="Gtk.Callback" />
<Parameter Name="marshal" Type="Gtk.CallbackMarshal" />
<Parameter Name="callback_data" Type="System.IntPtr" />
<Parameter Name="notify" Type="Gtk.DestroyNotify" />
</Parameters>
<Docs>
<summary>Runs <paramref name="cb" /> over every item in this container.</summary>
<param name="cb">a <see cref="T:Gtk.Callback" /></param>
<param name="marshal">a <see cref="T:Gtk.CallbackMarshal" /></param>
<param name="callback_data">a <see cref="T:System.IntPtr" />, the data to pass to the callback method.</param>
<param name="notify">a <see cref="T:Gtk.DestroyNotify" /></param>
<remarks>FIXME: this should be clarified.</remarks>
</Docs>
</Member>
<Member MemberName="Item">
<MemberSignature Language="C#" Value="public virtual Gtk.Container+ContainerChild Item[Gtk.Widget w] { get; };" />
<MemberType>Property</MemberType>
<ReturnValue>
<ReturnType>Gtk.Container+ContainerChild</ReturnType>
</ReturnValue>
<Parameters>
<Parameter Name="w" Type="Gtk.Widget" />
</Parameters>
<Docs>
<summary>Access for child properties</summary>
<param name="w">a child of this container</param>
<value>a <see cref="T:Gtk.Container+ContainerChild" /></value>
<remarks>The base <see cref="T:Gtk.Container+ContainerChild" /> type is not very useful; you will normally need to cast it to a subclass of the appropriate type.</remarks>
</Docs>
</Member>
</Members>
</Type>