Function

GtkTreeRowReferencenew

Declaration [src]

GtkTreeRowReference*
gtk_tree_row_reference_new (
  GtkTreeModel* model,
  GtkTreePath* path
)

Description [src]

Creates a row reference based on path.

This reference will keep pointing to the node pointed to by path, so long as it exists. Any changes that occur on model are propagated, and the path is updated appropriately. If path isn’t a valid path in model, then NULL is returned.

Parameters

model

Type: GtkTreeModel

A GtkTreeModel.

The data is owned by the caller of the function.
path

Type: GtkTreePath

A valid GtkTreePath-struct to monitor.

The data is owned by the caller of the function.

Return value

Type: GtkTreeRowReference

A newly allocated GtkTreeRowReference, or NULL.

The caller of the function takes ownership of the data, and is responsible for freeing it.