Tree Iterator: a pointer to an entry in a TreeModel. The constructor of this structure is public for the sake of creating custom tree models. The first value is a time stamp that is handled by the functions that interface with Gtk. The time stamps are used to print warnings if programmers use an iter to a model that has changed meanwhile. The other three fields are used by the custom model implementation to implement an indexing scheme. The precise use of the three words is therefore implementation specific. See also TreePath.

TreePath : a list of indices to specify a subtree or node in a TreeModel. The node that correspond to a given TreePath might change if nodes are removed or added and a TreePath may refer to a different or even non-existent node after a modification of the model. In contrast, a TreeIter is a more compact representation of a TreePath which becomes invalid after each modification of the underlying model. An intelligent index that is adjusted with each update of the model to point to the same node (whenever possible) is TreeRowReference.

The type of a tree column.

Create a ColumnId to extract an integer.

Create a ColumnId to extract an Boolean.

Create a ColumnId to extract an string.

Create a ColumnId to extract an Pixbuf.

The invalid ColumnId. Widgets use this value if no column id has been set.

Convert a ColumnId to a bare number.

Convert a comma or colon separated string into a TreePath. Any non-digit characters are assumed to separate indices, thus, the function always is always successful.

Returns a set of flags supported by this interface.

The flags supported should not change during the lifecycle of the tree_model.

Turn a TreePath into a TreeIter.

Returns Nothing if the given TreePath was invalid. The empty list is always invalid. The root node of a tree can be accessed by passing [0] as path.

Turn a String into a TreeIter.

• Returns Nothing if the string is not a colon separated list of numbers that references a valid node.

Retrieves an TreeIter to the first entry.

Returns Nothing if the table is empty.

Turn an abstract TreeIter into a TreePath.

In case the given TreeIter was invalid, an empty list is returned.

Read the value of at a specific column and TreeIter.

Retrieve an iterator to the node following it at the current level. If there is no next node, Nothing is returned.

Retrieve an iterator to the first child of parent. If parent has no children, Nothing.

Returns True if iter has children, False otherwise.

Returns the number of children that iter has. As a special case, if iter is Nothing, then the number of toplevel nodes is returned.

Retrieve the nth child of parent, counting from zero. If n is too big or parent has no children, Nothing is returned. If Nothing is specified for the parent argument, the function will return the nth root node.

Retrieve the parent of this iterator.

Maps a function over each node in model in a depth-first fashion. If it returns True, then the tree ceases to be walked, and treeModelForeach returns.

Generates a string representation of the iter. This string is a ':' separated list of numbers. For example, "4:10:0:3" would be an acceptable return value for this string.

• Available since Gtk+ version 2.2

Lets the tree ref the node. This is an optional method for models to implement. To be more specific, models may ignore this call as it exists primarily for performance reasons.

This function is primarily meant as a way for views to let caching model know when nodes are being displayed (and hence, whether or not to cache that node.) For example, a file-system based model would not want to keep the entire file-hierarchy in memory, just the sections that are currently being displayed by every current view.

A model should be expected to be able to get an iter independent of its reffed state.

Lets the tree unref the node. This is an optional method for models to implement. To be more specific, models may ignore this call as it exists primarily for performance reasons.

For more information on what this means, see treeModelRefNode. Please note that nodes that are deleted are not unreffed.

Emits the rowChanged signal on the model.

• This function is only necessary to implement a custom tree model. When using ListStore or TreeStore, this function is called automatically.

Emits the rowInserted signal on the model.

• This function is only necessary to implement a custom tree model. When using ListStore or TreeStore, this function is called automatically.

Emits the rowHasChildToggled signal on the model. This should be called by models after the child state of a node changes.

• This function is only necessary to implement a custom tree model. When using ListStore or TreeStore, this function is called automatically.

Emits the rowDeleted signal on the model. This should be called by models after a row has been removed. The location pointed to by path should be the location that the row previously was at. It may not be a valid location anymore.

• This function is only necessary to implement a custom tree model. When using ListStore or TreeStore, this function is called automatically.

Emits the rowsReordered signal on the model. This should be called by models when their rows have been reordered. The length of newOrder must be equal to the value returned by treeModelIterNChildren self iter.

• This function is only necessary to implement a custom tree model. When using ListStore or TreeStore, this function is called automatically.

This signal is emitted when a row in the model has changed.

This signal is emitted when a new row has been inserted in the model.

This signal is emitted when a row has gotten the first child row or lost its last child row.

This signal is emitted when a row has been deleted.

Note that no iterator is passed to the signal handler, since the row is already deleted.

Implementations of TreeModel must emit row-deleted before removing the node from its internal data structures. This is because models and views which access and monitor this model might have references on the node which need to be released in the rowDeleted handler.

This signal is emitted when the children of a node in the TreeModel have been reordered. See treeModelRowsReordered for more information about the parameters that this signal carries.

Note that this signal is not emitted when rows are reordered by DND, since this is implemented by removing and then reinserting the row.