append_with_siblings


Description:

[ Version ( since = "3.2" ) ]
public int append_with_siblings (WidgetPath siblings, uint sibling_index)

Appends a widget type with all its siblings to the widget hierarchy represented by this.

Using this function instead of append_type will allow the CSS theming to use sibling matches in selectors and apply GtkWidgetPath:nth-child() pseudo classes. In turn, it requires a lot more care in widget implementations as widgets need to make sure to call reset_style on all involved widgets when the siblings path changes.

Parameters:

this

the widget path to append to

siblings

a widget path describing a list of siblings. This path may not contain any siblings itself and it must not be modified afterwards.

sibling_index

index into siblings for where the added element is positioned.

Returns:

the position where the element was inserted.