Creates a row reference based on path.
Class GtkTreeRowReference( model, path )
| model | A GtkTreeModel | ||
| path | A valid GtkTreePath to monitor | ||
| Raise |
|
This reference will keep pointing to the node pointed to by path, so long as it exists. It listens to all signals emitted by model, and updates its path appropriately. If path isn't a valid path in model, a param error is raised.
| Methods | |
| copy | Copies a GtkTreeRowReference. |
| deleted | Lets a set of row reference created by gtk_tree_row_reference_new_proxy() know that the model emitted the "row_deleted" signal. |
| get_model | Returns the model that the row reference is monitoring. |
| get_path | Returns a path that the row reference currently points to, or NULL if the path pointed to is no longer valid. |
| inserted | Lets a set of row reference created by gtk_tree_row_reference_new_proxy() know that the model emitted the "row_inserted" signal. |
| new_proxy | You do not need to use this function. Creates a row reference based on path. This reference will keep pointing to the node pointed to by path, so long as it exists. If path isn't a valid path in model, then NULL is returned. However, unlike references created with gtk_tree_row_reference_new(), it does not listen to the model for changes. The creator of the row reference must do this explicitly using gtk_tree_row_reference_inserted(), gtk_tree_row_reference_deleted(), gtk_tree_row_reference_reordered(). |
| reordered | Lets a set of row reference created by gtk_tree_row_reference_new_proxy() know that the model emitted the "rows_reordered" signal. |
| valid | Returns TRUE if the reference refers to a current valid path. |
Copies a GtkTreeRowReference.
GtkTreeRowReference.copy()
| Return | a copy of reference. |
Lets a set of row reference created by gtk_tree_row_reference_new_proxy() know that the model emitted the "row_deleted" signal.
GtkTreeRowReference.deleted( proxy, path )
| proxy | A GObject |
| path | The path position that was deleted |
Returns the model that the row reference is monitoring.
GtkTreeRowReference.get_model()
| Return | the model |
Returns a path that the row reference currently points to, or NULL if the path pointed to is no longer valid.
GtkTreeRowReference.get_path()
| Return | A current path, or NULL. |
Lets a set of row reference created by gtk_tree_row_reference_new_proxy() know that the model emitted the "row_inserted" signal.
GtkTreeRowReference.inserted( proxy, path )
| proxy | A GObject |
| path | The row position that was inserted |
You do not need to use this function. Creates a row reference based on path. This reference will keep pointing to the node pointed to by path, so long as it exists. If path isn't a valid path in model, then NULL is returned. However, unlike references created with gtk_tree_row_reference_new(), it does not listen to the model for changes. The creator of the row reference must do this explicitly using gtk_tree_row_reference_inserted(), gtk_tree_row_reference_deleted(), gtk_tree_row_reference_reordered().
GtkTreeRowReference.new_proxy( proxy, model, path )
| proxy | A proxy GObject | ||
| model | A GtkTreeModel | ||
| path | A valid GtkTreePath to monitor | ||
| Return | A new GtkTreeRowReference | ||
| Raise |
|
These functions must be called exactly once per proxy when the corresponding signal on the model is emitted. This single call updates all row references for that proxy. Since built-in GTK+ objects like GtkTreeView already use this mechanism internally, using them as the proxy object will produce unpredictable results. Further more, passing the same object as model and proxy doesn't work for reasons of internal implementation.
This type of row reference is primarily meant by structures that need to carefully monitor exactly when a row reference updates itself, and is not generally needed by most applications.
Lets a set of row reference created by gtk_tree_row_reference_new_proxy() know that the model emitted the "rows_reordered" signal.
GtkTreeRowReference.reordered( proxy, path, iter, new_order )
| proxy | A GObject |
| path | The parent path of the reordered signal |
| iter | The iter pointing to the parent of the reordered |
| new_order | The new order of rows (array of integers) |
Returns TRUE if the reference refers to a current valid path.
GtkTreeRowReference.valid()
| Return | TRUE if reference points to a valid path. |