gtk-sharp 2.12.0.0 Gtk# is thread aware, but not thread safe; See the Gtk# Thread Programming for details. Base class for widgets which contain other widgets A Gtk# user interface is constructed by nesting widgets inside widgets. widgets are the inner nodes in the resulting tree of widgets: they contain other widgets. So, for example, you might have a containing a containing a . If you wanted an image instead of a textual label inside the frame, you might replace the widget with a widget. There are two major kinds of widgets in Gtk#. Both are subclasses of the abstract base class. The first type of widget has a single child widget and derives from . These containers are decorators, which add some kind of functionality to the child. For example, a makes its child into a clickable button; a draws a frame around its child and a places its child widget inside a top-level . The second type of 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 arranges its children in a horizontal row, and a arranges the widgets it contains in a two-dimensional grid. To fulfill its task, a layout must negotiate the size requirements with its parent and its children. This negotiation is carried out in two phases, size requisition and size allocation. Gtk.Widget System.Collections.IEnumerable System.Reflection.DefaultMember("Item") Method System.Void Attempts to resize this container. Method System.Void Gets the values of one or more child properties for child and container. an object of type an object of type an object of type Gets the values of one or more child properties for child and container. Method System.Void Adds a to the . an object of type Typically used for simple containers such as , , or ; for more complicated layout containers such as or , this function will pick default packing parameters that may not be correct. So consider functions such as and as an alternative to in those cases. A may be added to only one at a time; you can not place the same widget inside two different containers. Method System.Void Removes a from the . an object of type must be inside . Method System.Void Removes a focus chain. Removes a focus chain explicitly set with . Method System.Void Tries to resize the child widgets of this container. Method System.Void Sets a child property of a . a child of this the child property name the value to set to You will not normally need to use this method; Gtk# automatically generates child property accessors for all subclasses. Method GLib.Value Gets a child property of a . a child of this the child property name You will not normally need to use this method; Gtk# automatically generates child property accessors for all subclasses. To be added. Method System.Void Send synthetic expose events to all children that do not have their own . an object of type an object of type When a receives an expose event, it must send synthetic expose events to all children that do not have their own s. This function provides a convenient way of doing this. A , when it receives an expose event, calls once for each child, passing in the event the received. 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. In most cases, a can either simply inherit the expose implementation from , or do some drawing and then chain to the expose implementation from . Method System.Void Sets one or more child properties for child and . an object of type an object of type an object of type Sets one or more child properties for child and . Constructor Internal constructor Pointer to the C object. This is an internal constructor, and should not be used by user code. Property Gtk.Adjustment The vertical focus adjustment. an object of type Property Gtk.Adjustment The horizontal focus adjustment. an object of type Property Gtk.Widget Moves the focus to a particular child widget or finds the last-focused widget. an object of type Property System.Boolean The redraw-reallocation flag. Containers requesting reallocation redraws get automatically redrawn if any of their children changed allocation. an object of type Property Gtk.Widget A child widget for this container. an object of type GLib.Property("child") Property Gtk.ResizeMode How this container behaves when resized. an object of type GLib.Property("resize-mode") Property System.UInt32 This container's border width. A GLib.Property("border-width") Event Gtk.AddedHandler Raised when a child widget is added to the container via . Note that this event is raised only when (or its C equivalent) is called. It is not a generic widget-added notification. For example, calling will not result in this event firing. GLib.Signal("add") Event Gtk.FocusChildSetHandler Raised when the focus moves to a child widget of this container. GLib.Signal("set-focus-child") Event Gtk.RemovedHandler Raised when a child widget is removed from this container Note that this event is raised only when (or its C equivalent) is called. If a subclass defines additional methods for removing widgets, then calling those methods will not result in this event being raised. GLib.Signal("remove") Event System.EventHandler Raised when this container's resizability is queried. GLib.Signal("check_resize") Property GLib.GType GType Property. a Returns the native value for . Method System.Void Default handler for the event. Override this method in a subclass to provide a default handler for the event. Method System.Void Default handler for the event. a Override this method in a subclass to provide a default handler for the event. Method System.Void Default handler for the event. a Override this method in a subclass to provide a default handler for the event. Method System.Void Default handler for the event. a Override this method in a subclass to provide a default handler for the event. Method System.Void 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. a Most applications should use instead of this method. Method System.Void Invokes a callback function on each non-internal child of this container. See for more details on internal children. a Most applications should use this method instead of . Constructor Protected Constructor. a Chain to this constructor if you have manually registered a native value for your subclass. System.Obsolete Property Gtk.Widget[] Obtains an array of the container's (non-internal) children. An array of non-internal children. 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. If you simply want to do a loop on the container's children, you do not need to use the Children property. Just do: foreach (Widget w in myContainer) { // Do something with w } Method System.Collections.IEnumerator Returns an for the container's children a implements , so you can iterate through its children like this: foreach (Widget w in myContainer) { // Do something with w } Property System.Collections.IEnumerable Allows you to enumerate all of the container's children. an Enumerates all of the container's children, including those widgets that are internal implementation details of the container. Property Gtk.Widget[] Sets or obtains a focus chain of the container, overriding the one computed automatically by Gtk#. An array of . In principle each in the chain should be a descendant of the , 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. 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 in focusable_widgets and returns . Constructor Protected constructor for chaining by descendant classes. Method System.Void Run a given callback for every object inside this container. a , whether to include "internal" children when running the callback. a Deprecated: overload instead. Method System.Void Run a given callback for every object inside this container. a , whether to include "internal" children when running the callback. a Overload this in subclasses of Gtk.Container to implement the and methods. Method GLib.GType Returns the type of children supported by this container. a If you override this in a derived container class, you must not call base.ChildType() from the overridden method. Property Gtk.Container+ContainerChild Access for child properties a child of this container a The base type is not very useful; you will normally need to cast it to a subclass of the appropriate type.