gtkmm: Gtk::TreeRowReference Class Reference

Typedefed as Gtk::TreeModel::RowReference. More...

#include <gtkmm/treerowreference.h>

Public Member Functions

 TreeRowReference ()
 
 TreeRowReference (GtkTreeRowReference* gobject, bool make_a_copy=true)
 
 TreeRowReference (const TreeRowReference& other)
 
TreeRowReferenceoperator= (const TreeRowReference& other)
 
 TreeRowReference (TreeRowReference&& other) noexcept
 
TreeRowReferenceoperator= (TreeRowReference&& other) noexcept
 
 ~TreeRowReference () noexcept
 
void swap (TreeRowReference& other) noexcept
 
GtkTreeRowReference* gobj ()
 Provides access to the underlying C instance. More...

 
const GtkTreeRowReference* gobj () const
 Provides access to the underlying C instance. More...

 
GtkTreeRowReference* gobj_copy () const
 Provides access to the underlying C instance. The caller is responsible for freeing it. Use when directly setting fields in structs. More...

 
 TreeRowReference (const Glib::RefPtr< TreeModel >& model, const TreeModel::Path& path)
 
 operator bool () const
 The same as is_valid(). More...

 
TreeModel::Path get_path () const
 Returns a path that the row reference currently points to, or nullptr if the path pointed to is no longer valid. More...

 
Glib::RefPtr< TreeModelget_model ()
 Returns the model that the row reference is monitoring. More...

 
Glib::RefPtr< const TreeModelget_model () const
 Returns the model that the row reference is monitoring. More...

 
bool is_valid () const
 Returns true if the reference is non-nullptr and refers to a current valid path. More...

 

Static Public Member Functions

static GType get_type ()
 Get the GType for this class, for use with the underlying GObject type system. More...

 

Protected Attributes

GtkTreeRowReference* gobject_
 

Related Functions

(Note that these are not member functions.)

void swap (TreeRowReference& lhs, TreeRowReference& rhs) noexcept
 
Gtk::TreeRowReference wrap (GtkTreeRowReference* object, bool take_copy=false)
 A Glib::wrap() method for this object. More...

 

Detailed Description

Typedefed as Gtk::TreeModel::RowReference.

This reference will keep pointing to the node pointed to by the Path, so long as it exists. It listens to all signals emitted by the Model, and updates its Path appropriately.

Constructor & Destructor Documentation

Gtk::TreeRowReference::TreeRowReference ( )
Gtk::TreeRowReference::TreeRowReference ( GtkTreeRowReference *  gobject,
bool  make_a_copy = true 
)
explicit
Gtk::TreeRowReference::TreeRowReference ( const TreeRowReference other)
Gtk::TreeRowReference::TreeRowReference ( TreeRowReference&&  other)
noexcept
Gtk::TreeRowReference::~TreeRowReference ( )
noexcept
Gtk::TreeRowReference::TreeRowReference ( const Glib::RefPtr< TreeModel >&  model,
const TreeModel::Path path 
)

Member Function Documentation

Glib::RefPtr<TreeModel> Gtk::TreeRowReference::get_model ( )

Returns the model that the row reference is monitoring.

Returns
The model.
Glib::RefPtr<const TreeModel> Gtk::TreeRowReference::get_model ( ) const

Returns the model that the row reference is monitoring.

Returns
The model.
TreeModel::Path Gtk::TreeRowReference::get_path ( ) const

Returns a path that the row reference currently points to, or nullptr if the path pointed to is no longer valid.

Returns
A current path, or nullptr.
static GType Gtk::TreeRowReference::get_type ( )
static

Get the GType for this class, for use with the underlying GObject type system.

GtkTreeRowReference* Gtk::TreeRowReference::gobj ( )
inline

Provides access to the underlying C instance.

const GtkTreeRowReference* Gtk::TreeRowReference::gobj ( ) const
inline

Provides access to the underlying C instance.

GtkTreeRowReference* Gtk::TreeRowReference::gobj_copy ( ) const

Provides access to the underlying C instance. The caller is responsible for freeing it. Use when directly setting fields in structs.

bool Gtk::TreeRowReference::is_valid ( ) const

Returns true if the reference is non-nullptr and refers to a current valid path.

Returns
true if reference points to a valid path.
Gtk::TreeRowReference::operator bool ( ) const
explicit

The same as is_valid().

For instance,

if(treerowreference)
do_something()
Since gtkmm 3.22:
TreeRowReference& Gtk::TreeRowReference::operator= ( const TreeRowReference other)
TreeRowReference& Gtk::TreeRowReference::operator= ( TreeRowReference&&  other)
noexcept
void Gtk::TreeRowReference::swap ( TreeRowReference other)
noexcept

Friends And Related Function Documentation

void swap ( TreeRowReference lhs,
TreeRowReference rhs 
)
related
Parameters
lhsThe left-hand side
rhsThe right-hand side
Gtk::TreeRowReference wrap ( GtkTreeRowReference *  object,
bool  take_copy = false 
)
related

A Glib::wrap() method for this object.

Parameters
objectThe C instance.
take_copyFalse if the result should take ownership of the C instance. True if it should take a new copy or ref.
Returns
A C++ instance that wraps this C instance.

Member Data Documentation

GtkTreeRowReference* Gtk::TreeRowReference::gobject_
protected