gtk.TreeRowReference — an object maintaining a persistent reference to a gtk.TreeModel
row (new in PyGTK 2.4)
class gtk.TreeRowReference(gobject.GBoxed): |
This object is available in PyGTK 2.4 and above.
A gtk.TreeRowReference
is an object that points to a row in a gtk.TreeModel
similar to a gtk.TreeIter. A
gtk.TreeRowReference,
unlike a gtk.TreeIter,
maintains a persistent reference in spite of changes in the model.
gtk.TreeRowReference(model, path)model : | a gtk.TreeModel |
path : | a valid tree path to monitor |
| Returns : | a gtk.TreeRowReference,
or None |
This constructor is available in PyGTK 2.4 and above.
Creates a row reference pointing to the treemodel row specified by
model and path. This reference
will continue pointing to the node in spite of changes in
model. It listens to all signals emitted by
model, and updates its path appropriately. If
path isn't a valid path in
model, None is returned.
def get_path()| Returns : | A current path, or
None. |
This method is available in PyGTK 2.4 and above.
The get_path() method returns the path
that the row reference currently points to, or None if
the path pointed to is no longer valid.
def get_model()| Returns : | the model, or
None. |
This method is available in PyGTK 2.8 and above.
The get_model() method returns the
model that the row reference currently monitors, or None
if the model is not set.
def valid()| Returns : | True if the row reference
points to a valid path. |
This method is available in PyGTK 2.4 and above.
The valid() method returns
True if the row reference is not None
and refers to a current valid path.