[−]Struct gtk::Container

pub struct Container(_, _);

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`

`fn clone(&self) -> Container`

`fn clone_from(&mut self, source: &Self)`1.0.0[src]

`impl Debug for Container`

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

`impl Display for Container`[src]

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

`impl Eq for Container`

`impl Hash for Container`

`fn hash<H: Hasher>(&self, state: &mut H)`

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

`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`

`fn cmp(&self, other: &Container) -> Ordering`

`#[must_use]fn max(self, other: Self) -> Self`1.21.0[src]

`#[must_use]fn min(self, other: Self) -> Self`1.21.0[src]

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

`impl<T: ObjectType> PartialEq<T> for Container`

`fn eq(&self, other: &T) -> bool`

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

`impl<T: ObjectType> PartialOrd<T> for Container`

`fn partial_cmp(&self, other: &T) -> Option<Ordering>`

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

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

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

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

`impl StaticType for Container`

`fn static_type() -> Type`

Auto Trait Implementations

`impl RefUnwindSafe for Container`

`impl !Send for Container`

`impl !Sync for Container`

`impl Unpin for Container`

`impl UnwindSafe for Container`

Blanket Implementations

`impl<T> Any for T where T: 'static + ?Sized,` [src]

`fn type_id(&self) -> TypeId`[src]

`impl<T> Borrow<T> for T where T: ?Sized,` [src]

`fn borrow(&self) -> &T`[src]

`impl<T> BorrowMut<T> for T where T: ?Sized,` [src]

`fn borrow_mut(&mut self) -> &mut T`[src]

`impl<Super, Sub> CanDowncast<Sub> for Super where Sub: IsA<Super>, Super: IsA<Super>,`

`impl<T> Cast for T where T: ObjectType,`

`fn upcast<T>(self) -> T where Self: IsA<T>, T: ObjectType,`

`fn upcast_ref<T>(&self) -> &T where Self: IsA<T>, T: ObjectType,`

`fn downcast<T>(self) -> Result<T, Self> where Self: CanDowncast<T>, T: ObjectType,`

`fn downcast_ref<T>(&self) -> Option<&T> where Self: CanDowncast<T>, T: ObjectType,`

`fn dynamic_cast<T>(self) -> Result<T, Self> where T: ObjectType,`

`fn dynamic_cast_ref<T>(&self) -> Option<&T> where T: ObjectType,`

`unsafe fn unsafe_cast<T>(self) -> T where T: ObjectType,`

`unsafe fn unsafe_cast_ref<T>(&self) -> &T where T: ObjectType,`

`impl<T> From<T> for T`[src]

`fn from(t: T) -> T`[src]

`impl<T, U> Into<U> for T where U: From<T>,` [src]

`fn into(self) -> U`[src]

`impl<T> ObjectExt for T where T: ObjectType,`

`fn is<U>(&self) -> bool where U: StaticType,`

`fn get_type(&self) -> Type`

`fn get_object_class(&self) -> &ObjectClass`

`fn set_properties( &self, property_values: &[(&str, &dyn ToValue)] ) -> Result<(), BoolError>`

`fn set_property<'a, N>( &self, property_name: N, value: &dyn ToValue ) -> Result<(), BoolError> where N: Into<&'a str>,`

`fn get_property<'a, N>(&self, property_name: N) -> Result<Value, BoolError> where N: Into<&'a str>,`

`unsafe fn set_qdata<QD>(&self, key: Quark, value: QD) where QD: 'static,`

`unsafe fn get_qdata<QD>(&self, key: Quark) -> Option<&QD> where QD: 'static,`

`unsafe fn steal_qdata<QD>(&self, key: Quark) -> Option<QD> where QD: 'static,`

`unsafe fn set_data<QD>(&self, key: &str, value: QD) where QD: 'static,`

`unsafe fn get_data<QD>(&self, key: &str) -> Option<&QD> where QD: 'static,`

`unsafe fn steal_data<QD>(&self, key: &str) -> Option<QD> where QD: 'static,`

`fn block_signal(&self, handler_id: &SignalHandlerId)`

`fn unblock_signal(&self, handler_id: &SignalHandlerId)`

`fn stop_signal_emission(&self, signal_name: &str)`

`fn disconnect(&self, handler_id: SignalHandlerId)`

`fn connect_notify<F>(&self, name: Option<&str>, f: F) -> SignalHandlerId where F: 'static + Send + Sync + Fn(&T, &ParamSpec),`

`unsafe fn connect_notify_unsafe<F>( &self, name: Option<&str>, f: F ) -> SignalHandlerId where F: Fn(&T, &ParamSpec),`

`fn notify<'a, N>(&self, property_name: N) where N: Into<&'a str>,`

`fn notify_by_pspec(&self, pspec: &ParamSpec)`

`fn has_property<'a, N>(&self, property_name: N, type_: Option<Type>) -> bool where N: Into<&'a str>,`

`fn get_property_type<'a, N>(&self, property_name: N) -> Option<Type> where N: Into<&'a str>,`

`fn find_property<'a, N>(&self, property_name: N) -> Option<ParamSpec> where N: Into<&'a str>,`

`fn list_properties(&self) -> Vec<ParamSpec>`

`fn connect<'a, N, F>( &self, signal_name: N, after: bool, callback: F ) -> Result<SignalHandlerId, BoolError> where F: Fn(&[Value]) -> Option<Value> + Send + Sync + 'static, N: Into<&'a str>,`

`fn connect_local<'a, N, F>( &self, signal_name: N, after: bool, callback: F ) -> Result<SignalHandlerId, BoolError> where F: Fn(&[Value]) -> Option<Value> + 'static, N: Into<&'a str>,`

`unsafe fn connect_unsafe<'a, N, F>( &self, signal_name: N, after: bool, callback: F ) -> Result<SignalHandlerId, BoolError> where F: Fn(&[Value]) -> Option<Value>, N: Into<&'a str>,`

`fn emit<'a, N>( &self, signal_name: N, args: &[&dyn ToValue] ) -> Result<Option<Value>, BoolError> where N: Into<&'a str>,`

`fn downgrade(&self) -> WeakRef<T>`

`fn bind_property<'a, O, N, M>( &'a self, source_property: N, target: &'a O, target_property: M ) -> BindingBuilder<'a> where M: Into<&'a str>, N: Into<&'a str>, O: ObjectType,`

`fn ref_count(&self) -> u32`

`impl<'a, T> ToGlibContainerFromSlice<'a, *const GList> for T where T: GlibPtrDefault + ToGlibPtr<'a, <T as GlibPtrDefault>::GlibType>,`

`type Storage = (Option<List>, Vec<Stash<'a, <T as GlibPtrDefault>::GlibType, T>>)`

`fn to_glib_none_from_slice( t: &'a [T] ) -> (const GList, <T as ToGlibContainerFromSlice<'a, const GList>>::Storage)`

`fn to_glib_container_from_slice( _t: &'a [T] ) -> (const GList, <T as ToGlibContainerFromSlice<'a, const GList>>::Storage)`

`fn to_glib_full_from_slice(_t: &[T]) -> *const GList`

`impl<'a, T> ToGlibContainerFromSlice<'a, *const GPtrArray> for T where T: GlibPtrDefault + ToGlibPtr<'a, <T as GlibPtrDefault>::GlibType>,`

`type Storage = (Option<PtrArray>, Vec<Stash<'a, <T as GlibPtrDefault>::GlibType, T>>)`

`fn to_glib_none_from_slice( t: &'a [T] ) -> (const GPtrArray, <T as ToGlibContainerFromSlice<'a, const GPtrArray>>::Storage)`

`fn to_glib_container_from_slice( _t: &'a [T] ) -> (const GPtrArray, <T as ToGlibContainerFromSlice<'a, const GPtrArray>>::Storage)`

`fn to_glib_full_from_slice(_t: &[T]) -> *const GPtrArray`

`impl<'a, T> ToGlibContainerFromSlice<'a, *mut GArray> for T where T: GlibPtrDefault + ToGlibPtr<'a, <T as GlibPtrDefault>::GlibType>,`

`type Storage = (Option<Array>, Vec<Stash<'a, <T as GlibPtrDefault>::GlibType, T>>)`

`fn to_glib_none_from_slice( t: &'a [T] ) -> (mut GArray, <T as ToGlibContainerFromSlice<'a, mut GArray>>::Storage)`

`fn to_glib_container_from_slice( t: &'a [T] ) -> (mut GArray, <T as ToGlibContainerFromSlice<'a, mut GArray>>::Storage)`

`fn to_glib_full_from_slice(t: &[T]) -> *mut GArray`

`impl<'a, T> ToGlibContainerFromSlice<'a, *mut GList> for T where T: GlibPtrDefault + ToGlibPtr<'a, <T as GlibPtrDefault>::GlibType>,`

`type Storage = (Option<List>, Vec<Stash<'a, <T as GlibPtrDefault>::GlibType, T>>)`

`fn to_glib_none_from_slice( t: &'a [T] ) -> (mut GList, <T as ToGlibContainerFromSlice<'a, mut GList>>::Storage)`

`fn to_glib_container_from_slice( t: &'a [T] ) -> (mut GList, <T as ToGlibContainerFromSlice<'a, mut GList>>::Storage)`

`fn to_glib_full_from_slice(t: &[T]) -> *mut GList`

`impl<'a, T> ToGlibContainerFromSlice<'a, *mut GPtrArray> for T where T: GlibPtrDefault + ToGlibPtr<'a, <T as GlibPtrDefault>::GlibType>,`

`type Storage = (Option<PtrArray>, Vec<Stash<'a, <T as GlibPtrDefault>::GlibType, T>>)`

`fn to_glib_none_from_slice( t: &'a [T] ) -> (mut GPtrArray, <T as ToGlibContainerFromSlice<'a, mut GPtrArray>>::Storage)`

`fn to_glib_container_from_slice( t: &'a [T] ) -> (mut GPtrArray, <T as ToGlibContainerFromSlice<'a, mut GPtrArray>>::Storage)`

`fn to_glib_full_from_slice(t: &[T]) -> *mut GPtrArray`

`impl<T> ToOwned for T where T: Clone,` [src]

`type Owned = T`

The resulting type after obtaining ownership.

`fn to_owned(&self) -> T`[src]

`fn clone_into(&self, target: &mut T)`[src]

`impl<T> ToString for T where T: Display + ?Sized,` [src]

`default fn to_string(&self) -> String`[src]

`impl<T> ToValue for T where T: SetValue + ?Sized,`

`fn to_value(&self) -> Value`

`fn to_value_type(&self) -> Type`

`impl<T, U> TryFrom<U> for T where U: Into<T>,` [src]

`type Error = Infallible`

The type returned in the event of a conversion error.

`fn try_from(value: U) -> Result<T, <T as TryFrom<U>>::Error>`[src]

`impl<T, U> TryInto<U> for T where U: TryFrom<T>,` [src]

`type Error = <U as TryFrom<T>>::Error`

The type returned in the event of a conversion error.

`fn try_into(self) -> Result<U, <U as TryFrom<T>>::Error>`[src]