Module: wibox.hierarchy
Management of widget hierarchies.
Each widget hierarchy object has a widget
for which it saves e.g. size and transformation in its parent. Also, each
widget has a number of children.
-
🔗
wibox.hierarchy.new (context, widget, width, height, redraw_callback, layout_callback, callback_arg)
-
Create a new widget hierarchy that has no parent.
Parameters:
| context |
|
|
The context in which we are laid out. |
| widget |
|
|
The widget that is at the base of the hierarchy. |
| width |
|
|
The available width for this hierarchy. |
| height |
|
|
The available height for this hierarchy. |
| redraw_callback |
|
|
Callback that is called with the corresponding widget
hierarchy on widget::redraw_needed on some widget. |
| layout_callback |
|
|
Callback that is called with the corresponding widget
hierarchy on widget::layout_changed on some widget. |
| callback_arg |
|
|
A second argument that is given to the above callbacks. |
Returns:
A new widget hierarchy
-
🔗
wibox.hierarchy.count_widget (widget)
-
Add a widget to the list of widgets for which hierarchies should count their
occurrences. Note that for correct operations, the widget must not yet be
visible in any hierarchy.
Parameters:
| widget |
|
|
The widget that should be counted. |
-
🔗
:wibox.hierarchy.update (context, widget, width, height, region)
-> ()
-
Update a widget hierarchy with some new state.
Parameters:
| context |
|
|
The context in which we are laid out. |
| widget |
|
|
The widget that is at the base of the hierarchy. |
| width |
|
|
The available width for this hierarchy. |
| height |
|
|
The available height for this hierarchy. |
| region |
Optional |
|
A region to use for accumulating changed parts |
Returns:
A cairo region describing the changed parts (either the region
argument or a new, internally created region).
-
🔗
:wibox.hierarchy.get_widget ()
-> wibox.widget
-
Get the widget that this hierarchy manages.
Returns:
wibox.widget
The widget held by this node.
-
🔗
:wibox.hierarchy.get_matrix_to_parent ()
-> ()
-
Get a matrix that transforms to the parent's coordinate space from this
hierarchy's coordinate system.
Returns:
A matrix describing the transformation.
-
🔗
:wibox.hierarchy.get_matrix_to_device ()
-> ()
-
Get a matrix that transforms to the base of this hierarchy's coordinate
system (aka the coordinate system of the device that this
hierarchy is applied upon) from this hierarchy's coordinate system.
Returns:
A matrix describing the transformation.
-
🔗
:wibox.hierarchy.get_matrix_from_parent ()
-> ()
-
Get a matrix that transforms from the parent's coordinate space into this
hierarchy's coordinate system.
Returns:
A matrix describing the transformation.
-
🔗
:wibox.hierarchy.get_matrix_from_device ()
-> ()
-
Get a matrix that transforms from the base of this hierarchy's coordinate
system (aka the coordinate system of the device that this
hierarchy is applied upon) into this hierarchy's coordinate system.
Returns:
A matrix describing the transformation.
-
🔗
:wibox.hierarchy.get_draw_extents ()
-> ()
-
Get the extents that this hierarchy possibly draws to (in the current coordinate space).
This includes the size of this element plus the size of all children
(after applying the corresponding transformation).
Returns:
x, y, width, height
-
🔗
:wibox.hierarchy.get_size ()
-> ()
-
Get the size that this hierarchy logically covers (in the current coordinate space).
Returns:
width, height
-
🔗
:wibox.hierarchy.get_children ()
-> ()
-
Get a list of all children.
Returns:
List of all children hierarchies.
-
🔗
:wibox.hierarchy.get_count (widget)
-> ()
-
Count how often this widget is visible inside this hierarchy. This function
only works with widgets registered via count_widget.
Parameters:
| widget |
|
|
The widget that should be counted |
Returns:
The number of times that this widget is contained in this hierarchy.
-
🔗
:wibox.hierarchy.draw (context, cr)
-
Draw a hierarchy to some cairo context.
This function draws the widgets in this widget hierarchy to the given cairo
context. The context's clip is used to skip parts that aren't visible.
Parameters:
| context |
|
|
The context in which widgets are drawn. |
| cr |
|
|
The cairo context that is used for drawing. |