Gtk.ToolItemGroup¶

Subclasses:	None

Methods¶

Inherited:	Gtk.Container (35), Gtk.Widget (278), GObject.Object (37), Gtk.Buildable (10), Gtk.ToolShell (9)
Structs:	Gtk.ContainerClass (5), Gtk.WidgetClass (12), GObject.ObjectClass (5)

class	`new` (label)
	`get_collapsed` ()
	`get_drop_item` (x, y)
	`get_ellipsize` ()
	`get_header_relief` ()
	`get_item_position` (item)
	`get_label` ()
	`get_label_widget` ()
	`get_n_items` ()
	`get_nth_item` (index)
	`insert` (item, position)
	`set_collapsed` (collapsed)
	`set_ellipsize` (ellipsize)
	`set_header_relief` (style)
	`set_item_position` (item, position)
	`set_label` (label)
	`set_label_widget` (label_widget)

Virtual Methods¶

Inherited:	Gtk.Container (10), Gtk.Widget (82), GObject.Object (7), Gtk.Buildable (10), Gtk.ToolShell (9)

Properties¶

Inherited:	Gtk.Container (3), Gtk.Widget (39)

Name	Type	Flags	Short Description
`collapsed`	`bool`	r/w/en	Whether the group has been collapsed and items are hidden
`ellipsize`	`Pango.EllipsizeMode`	r/w/en	Ellipsize for item group headers
`header-relief`	`Gtk.ReliefStyle`	r/w/en	Relief of the group header button
`label`	`str`	r/w	The human-readable title of this item group
`label-widget`	`Gtk.Widget`	r/w	A widget to display in place of the usual label

Child Properties¶

Name	Type	Default	Flags	Short Description
`expand`	`bool`	`False`	r/w	Whether the item should receive extra space when the group grows
`fill`	`bool`	`True`	r/w	Whether the item should fill the available space
`homogeneous`	`bool`	`True`	r/w	Whether the item should be the same size as other homogeneous items
`new-row`	`bool`	`False`	r/w	Whether the item should start a new row
`position`	`int`	`0`	r/w	Position of the item within this group

Style Properties¶

Inherited:	Gtk.Widget (17)

Name	Type	Default	Flags	Short Description
`expander-size`	`int`	`16`	r	Size of the expander arrow
`header-spacing`	`int`	`2`	r	Spacing between expander arrow and caption

Signals¶

Inherited:	Gtk.Container (4), Gtk.Widget (69), GObject.Object (1)

Fields¶

Inherited:	Gtk.Container (4), Gtk.Widget (69), GObject.Object (1)

Name	Type	Access	Description
parent_instance	`Gtk.Container`	r

Class Details¶

class Gtk.ToolItemGroup(**kwargs)¶

Bases:	`Gtk.Container`, `Gtk.ToolShell`
Abstract:	No
Structure:	`Gtk.ToolItemGroupClass`

A Gtk.ToolItemGroup is used together with Gtk.ToolPalette to add Gtk.ToolItems to a palette like container with different categories and drag and drop support.

CSS nodes

Gtk.ToolItemGroup has a single CSS node named toolitemgroup.

New in version 2.20.

classmethod new(label)[source]¶

Parameters:	label (`str`) – the label of the new group
Returns:	a new `Gtk.ToolItemGroup`.
Return type:	`Gtk.Widget`

Creates a new tool item group with label label.

New in version 2.20.

get_collapsed()[source]¶

Returns:	`True` if self is collapsed, `False` if it is expanded
Return type:	`bool`

Gets whether self is collapsed or expanded.

New in version 2.20.

get_drop_item(x, y)[source]¶

Parameters:	x (`int`) – the x position y (`int`) – the y position
Returns:	the `Gtk.ToolItem` at position (x, y)
Return type:	`Gtk.ToolItem`

Gets the tool item at position (x, y).

New in version 2.20.

get_ellipsize()[source]¶

Returns:	the `Pango.EllipsizeMode` of self
Return type:	`Pango.EllipsizeMode`

Gets the ellipsization mode of self.

New in version 2.20.

get_header_relief()[source]¶

Returns:	the `Gtk.ReliefStyle`
Return type:	`Gtk.ReliefStyle`

Gets the relief mode of the header button of self.

New in version 2.20.

get_item_position(item)[source]¶

Parameters:	item (`Gtk.ToolItem`) – a `Gtk.ToolItem`
Returns:	the index of item in self or -1 if item is no child of self
Return type:	`int`

Gets the position of item in self as index.

New in version 2.20.

get_label()[source]¶

Returns:	the label of self. The label is an internal string of self and must not be modified. Note that `None` is returned if a custom label has been set with `Gtk.ToolItemGroup.set_label_widget`()
Return type:	`str`

Gets the label of self.

New in version 2.20.

get_label_widget()[source]¶

Returns:	the label widget of self
Return type:	`Gtk.Widget`

Gets the label widget of self. See Gtk.ToolItemGroup.set_label_widget().

New in version 2.20.

get_n_items()[source]¶

Returns:	the number of tool items in self
Return type:	`int`

Gets the number of tool items in self.

New in version 2.20.

get_nth_item(index)[source]¶

Parameters:	index (`int`) – the index
Returns:	the `Gtk.ToolItem` at index
Return type:	`Gtk.ToolItem`

Gets the tool item at index in group.

New in version 2.20.

insert(item, position)[source]¶

Parameters:	item (`Gtk.ToolItem`) – the `Gtk.ToolItem` to insert into self position (`int`) – the position of item in self, starting with 0. The position -1 means end of list.

Inserts item at position in the list of children of self.

New in version 2.20.

set_collapsed(collapsed)[source]¶

Parameters:	collapsed (`bool`) – whether the self should be collapsed or expanded

Sets whether the self should be collapsed or expanded.

New in version 2.20.

set_ellipsize(ellipsize)[source]¶

Parameters:	ellipsize (`Pango.EllipsizeMode`) – the `Pango.EllipsizeMode` labels in self should use

Sets the ellipsization mode which should be used by labels in self.

New in version 2.20.

set_header_relief(style)[source]¶

Parameters:	style (`Gtk.ReliefStyle`) – the `Gtk.ReliefStyle`

Set the button relief of the group header. See Gtk.Button.set_relief() for details.

New in version 2.20.

set_item_position(item, position)[source]¶

Parameters:	item (`Gtk.ToolItem`) – the `Gtk.ToolItem` to move to a new position, should be a child of self. position (`int`) – the new position of item in self, starting with 0. The position -1 means end of list.

Sets the position of item in the list of children of self.

New in version 2.20.

set_label(label)[source]¶

Parameters:	label (`str`) – the new human-readable label of of the group

Sets the label of the tool item group. The label is displayed in the header of the group.

New in version 2.20.

set_label_widget(label_widget)[source]¶

Parameters:	label_widget (`Gtk.Widget`) – the widget to be displayed in place of the usual label

Sets the label of the tool item group. The label widget is displayed in the header of the group, in place of the usual label.

New in version 2.20.

Property Details¶

Gtk.ToolItemGroup.props.collapsed¶

Name:	`collapsed`
Type:	`bool`
Default Value:	`False`
Flags:	`READABLE`, `WRITABLE`, `EXPLICIT_NOTIFY`

Whether the group has been collapsed and items are hidden

Gtk.ToolItemGroup.props.ellipsize¶

Name:	`ellipsize`
Type:	`Pango.EllipsizeMode`
Default Value:	`Pango.EllipsizeMode.NONE`
Flags:	`READABLE`, `WRITABLE`, `EXPLICIT_NOTIFY`

Ellipsize for item group headers

Gtk.ToolItemGroup.props.header_relief¶

Name:	`header-relief`
Type:	`Gtk.ReliefStyle`
Default Value:	`Gtk.ReliefStyle.NORMAL`
Flags:	`READABLE`, `WRITABLE`, `EXPLICIT_NOTIFY`

Relief of the group header button

Gtk.ToolItemGroup.props.label¶

Name:	`label`
Type:	`str`
Default Value:	`''`
Flags:	`READABLE`, `WRITABLE`

The human-readable title of this item group

Gtk.ToolItemGroup.props.label_widget¶

Name:	`label-widget`
Type:	`Gtk.Widget`
Default Value:	`None`
Flags:	`READABLE`, `WRITABLE`

A widget to display in place of the usual label