GtkTreeModelFilter: GtkTreeModelFilter
In RGtk2: R Bindings for Gtk 2.8.0 and Above

Description Methods and Functions Hierarchy Interfaces Detailed Description Structures Convenient Construction User Functions Properties Author(s) References See Also

A GtkTreeModel which hides parts of an underlying tree model

gtkTreeModelFilterNew(child.model, root = NULL)
gtkTreeModelFilterSetVisibleFunc(object, func, data = NULL)
gtkTreeModelFilterSetModifyFunc(object, types, func, data = NULL)
gtkTreeModelFilterSetVisibleColumn(object, column)
gtkTreeModelFilterGetModel(object)
gtkTreeModelFilterConvertChildIterToIter(object, child.iter)
gtkTreeModelFilterConvertIterToChildIter(object, filter.iter)
gtkTreeModelFilterConvertChildPathToPath(object, child.path)
gtkTreeModelFilterConvertPathToChildPath(object, filter.path)
gtkTreeModelFilterRefilter(object)
gtkTreeModelFilterClearCache(object)
gtkTreeModelFilter(child.model, root = NULL)

1 2	GObject +----GtkTreeModelFilter

GtkTreeModelFilter implements GtkTreeModel and GtkTreeDragSource.

A GtkTreeModelFilter is a tree model which wraps another tree model, and can do the following things:

Filter specific rows, based on data from a "visible column", a column storing booleans indicating whether the row should be filtered or not, or based on the return value of a "visible function", which gets a model, iter and user_data and returns a boolean indicating whether the row should be filtered or not.
Modify the "appearance" of the model, using a modify function. This is extremely powerful and allows for just changing some values and also for creating a completely different model based on the given child model.
Set a different root node, also known as a "virtual root". You can pass in a GtkTreePath indicating the root node for the filter at construction time.

GtkTreeModelFilter: The GtkTreeModelFilter struct contains only private fields.

gtkTreeModelFilter is the equivalent of gtkTreeModelFilterNew.

GtkTreeModelFilterVisibleFunc(model, iter, data)

A function which decides whether the row indicated by iter is visible.

model: the child model of the GtkTreeModelFilter
iter: a GtkTreeIter pointing to the row in model whose visibility is determined
data: user data given to gtkTreeModelFilterSetVisibleFunc

Returns: [logical] Whether the row indicated by iter is visible.

GtkTreeModelFilterModifyFunc(model, iter, value, column, data)

A function which calculates display values from raw values in the model. It must fill value with the display value for the column column in the row indicated by iter.

Since this function is called for each data access, it's not a particularly efficient operation.

model: the GtkTreeModelFilter
iter: a GtkTreeIter pointing to the row whose display values are determined
value: A R object which is already initialized for with the correct type for the column column.
column: the column whose display value is determined
data: user data given to gtkTreeModelFilterSetModifyFunc

child-model [GtkTreeModel : * : Read / Write / Construct Only]: The model for the filtermodel to filter.
virtual-root [GtkTreePath : * : Read / Write / Construct Only]: The virtual root (relative to the child model) for this filtermodel.

Derived by RGtkGen from GTK+ documentation

https://developer.gnome.org/gtk2/stable/GtkTreeModelFilter.html

GtkTreeModelSort

RGtk2 documentation built on Oct. 14, 2021, 5:08 p.m.