Struct gtk::Container

[+] Show declaration

pub struct Container(_, _);

[−] Expand description

A GTK+ user interface is constructed by nesting widgets inside widgets. Container widgets are the inner nodes in the resulting tree of widgets: they contain other widgets. So, for example, you might have a Window containing a Frame containing a Label. If you wanted an image instead of a textual label inside the frame, you might replace the Label widget with a Image widget.

There are two major kinds of container widgets in GTK+. Both are subclasses of the abstract Container base class.

The first type of container widget has a single child widget and derives from Bin. These containers are decorators, which add some kind of functionality to the child. For example, a Button makes its child into a clickable button; a Frame draws a frame around its child and a Window places its child widget inside a top-level window.

The second type of 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 HBox arranges its children in a horizontal row, and a Grid arranges the widgets it contains in a two-dimensional grid.

Child properties

Container introduces child properties. These are object properties that are not specific to either the container or the contained widget, but rather to their relation. Typical examples of child properties are the position or pack-type of a widget which is contained in a Box.

Container as Buildable

The Container implementation of the Buildable interface supports a <packing> element for children, which can contain multiple <property> elements that specify child properties for the child.

Since 2.16, child properties can also be marked as translatable using the same “translatable”, “comments” and “context” attributes that are used for regular properties.

Since 3.16, containers can have a <focus-chain> element containing multiple <widget> elements, one for each child that should be added to the focus chain. The ”name” attribute gives the id of the widget.

An example of these properties in UI definitions:

<object class="GtkBox">
  <child>
    <object class="GtkEntry" id="entry1"/>
    <packing>
      <property name="pack-type">start</property>
    </packing>
  </child>
  <child>
    <object class="GtkEntry" id="entry2"/>
  </child>
  <focus-chain>
    <widget name="entry1"/>
    <widget name="entry2"/>
  </focus-chain>
</object>

Implements

ContainerExt, WidgetExt

Trait Implementations

impl Clone for Container[+]

[+] Show hidden undocumented items

fn clone(&self) -> Container[−]

Returns a copy of the value.

fn clone_from(&mut self, source: &Self)[−]

Performs copy-assignment from source.

impl Debug for Container[+]

[+] Show hidden undocumented items

fn fmt(&self, f: &mut Formatter<'_>) -> Result[−]

Formats the value using the given formatter.

impl Display for Container[+]

[+] Show hidden undocumented items

fn fmt(&self, f: &mut Formatter<'_>) -> Result[−]

Formats the value using the given formatter.

impl Eq for Container

impl Hash for Container[+]

[+] Show hidden undocumented items

fn hash<__H: Hasher>(&self, state: &mut __H)[−]

Feeds this value into the given [Hasher].

fn hash_slice<H>(data: &[Self], state: &mut H) where
    H: Hasher, [−]

Feeds a slice of this type into the given [Hasher].

impl IsA<Buildable> for Container

impl IsA<Container> for AboutDialog

impl IsA<Container> for ActionBar

impl IsA<Container> for Button

impl IsA<Container> for ButtonBox

impl IsA<Container> for CheckButton

impl IsA<Container> for CheckMenuItem

impl IsA<Container> for ColorButton

impl IsA<Container> for ColorChooserDialog

impl IsA<Container> for ColorChooserWidget

impl IsA<Container> for ComboBox

impl IsA<Container> for ComboBoxText

impl IsA<Container> for Dialog

impl IsA<Container> for AppChooserButton

impl IsA<Container> for EventBox

impl IsA<Container> for Expander

impl IsA<Container> for FileChooserButton

impl IsA<Container> for FileChooserDialog

impl IsA<Container> for FileChooserWidget

impl IsA<Container> for Fixed

impl IsA<Container> for FlowBox

impl IsA<Container> for FlowBoxChild

impl IsA<Container> for FontButton

impl IsA<Container> for FontChooserDialog

impl IsA<Container> for AppChooserDialog

impl IsA<Container> for FontChooserWidget

impl IsA<Container> for Frame

impl IsA<Container> for Grid

impl IsA<Container> for HeaderBar

impl IsA<Container> for IconView

impl IsA<Container> for InfoBar

impl IsA<Container> for Layout

impl IsA<Container> for LinkButton

impl IsA<Container> for ListBox

impl IsA<Container> for ListBoxRow

impl IsA<Container> for AppChooserWidget

impl IsA<Container> for LockButton

impl IsA<Container> for Menu

impl IsA<Container> for MenuBar

impl IsA<Container> for MenuButton

impl IsA<Container> for MenuItem

impl IsA<Container> for MenuShell

impl IsA<Container> for MenuToolButton

impl IsA<Container> for MessageDialog

impl IsA<Container> for ModelButton

impl IsA<Container> for Notebook

impl IsA<Container> for ApplicationWindow

impl IsA<Container> for OffscreenWindow

impl IsA<Container> for Overlay

impl IsA<Container> for Paned

impl IsA<Container> for PlacesSidebar

impl IsA<Container> for Plug

impl IsA<Container> for Popover

impl IsA<Container> for PopoverMenu

impl IsA<Container> for RadioButton

impl IsA<Container> for RadioMenuItem

impl IsA<Container> for RadioToolButton

impl IsA<Container> for AspectFrame

impl IsA<Container> for RecentChooserDialog

impl IsA<Container> for RecentChooserMenu

impl IsA<Container> for RecentChooserWidget

impl IsA<Container> for Revealer

impl IsA<Container> for ScaleButton

impl IsA<Container> for ScrolledWindow

impl IsA<Container> for SearchBar

impl IsA<Container> for SeparatorMenuItem

impl IsA<Container> for SeparatorToolItem

impl IsA<Container> for ShortcutLabel

impl IsA<Container> for Assistant

impl IsA<Container> for ShortcutsGroup

impl IsA<Container> for ShortcutsSection

impl IsA<Container> for ShortcutsShortcut

impl IsA<Container> for ShortcutsWindow

impl IsA<Container> for Socket

impl IsA<Container> for Stack

impl IsA<Container> for StackSidebar

impl IsA<Container> for StackSwitcher

impl IsA<Container> for Statusbar

impl IsA<Container> for TextView

impl IsA<Container> for Bin

impl IsA<Container> for ToggleButton

impl IsA<Container> for ToggleToolButton

impl IsA<Container> for ToolButton

impl IsA<Container> for ToolItem

impl IsA<Container> for ToolItemGroup

impl IsA<Container> for ToolPalette

impl IsA<Container> for Toolbar

impl IsA<Container> for TreeView

impl IsA<Container> for Viewport

impl IsA<Container> for VolumeButton

impl IsA<Container> for Box

impl IsA<Container> for Window

impl IsA<Widget> for Container

impl Ord for Container[+]

[+] Show hidden undocumented items

fn cmp(&self, other: &Container) -> Ordering[−]

This method returns an [Ordering] between self and other.

[+] Expand attributes

#[must_use]fn max(self, other: Self) -> Self[−]

Compares and returns the maximum of two values.

[+] Expand attributes

#[must_use]fn min(self, other: Self) -> Self[−]

Compares and returns the minimum of two values.

[+] Expand attributes

#[must_use]fn clamp(self, min: Self, max: Self) -> Self[−]

🔬 This is a nightly-only experimental API. (clamp)

Restrict a value to a certain interval.

impl<T: ObjectType> PartialEq<T> for Container[+]

[+] Show hidden undocumented items

fn eq(&self, other: &T) -> bool[−]

This method tests for self and other values to be equal, and is used by ==.

[+] Expand attributes

#[must_use]fn ne(&self, other: &Rhs) -> bool[−]

This method tests for !=.

impl<T: ObjectType> PartialOrd<T> for Container[+]

[+] Show hidden undocumented items

fn partial_cmp(&self, other: &T) -> Option<Ordering>[−]

This method returns an ordering between self and other values if one exists.

[+] Expand attributes

#[must_use]fn lt(&self, other: &Rhs) -> bool[−]

This method tests less than (for self and other) and is used by the < operator.

[+] Expand attributes

#[must_use]fn le(&self, other: &Rhs) -> bool[−]

This method tests less than or equal to (for self and other) and is used by the <= operator.

[+] Expand attributes

#[must_use]fn gt(&self, other: &Rhs) -> bool[−]

This method tests greater than (for self and other) and is used by the > operator.

[+] Expand attributes

#[must_use]fn ge(&self, other: &Rhs) -> bool[−]

This method tests greater than or equal to (for self and other) and is used by the >= operator.

impl StaticType for Container[+]

[+] Show hidden undocumented items

fn static_type() -> Type[−]

Returns the type identifier of Self.