Main Page Widgets Namespaces Book

# Gtk::TreeRow Class Reference
[TreeView Classes]

Inheritance diagram for Gtk::TreeRow:

[legend]
List of all members.

## Detailed Description

Typedefed as TreeModel::Row.

Dereference a TreeModel::iterator to get the Row. Use operator[] or set_value() and get_value() to access the values in the columns of this row.

If the model contains a hierarchy of rows (such as Gtk::TreeStore), then you can access the child rows with children().

You can use a const TreeModel::Row& for any parameter that takes a const TreeModel::iterator&.

## Public Member Functions
const TreeNodeChildren& | children () const
| This returns an STL-like container API, for iterating over the rows.
template<class ColumnType>
void | get_value (int column, ColumnType& data) const
| Use get_value(const TreeModelColumn<>& column) unless you do not know the column type at compile-time.
template<class ColumnType>
ColumnType | get_value (const TreeModelColumn<ColumnType>& column) const
| Gets the value of this column of this row.
const GtkTreeIter* | gobj () const
| Provides access to the underlying C GObject.
GtkTreeIter* | gobj ()
| Provides access to the underlying C GObject.
| operator bool () const
| Discover whether this is a valid row.
template<class ColumnType>
TreeValueProxy<ColumnType> | operator[] (const TreeModelColumn<ColumnType>& column) const
| Use this to set and get the value of this column of this row.
TreeIter | parent () const
| Gets an iterator to the parent row of this row.
template<class ColumnType>
void | set_value (int column, const ColumnType& data) const
| Use set_value(const TreeModelColumn<>& column, const ColumnType& data) unless you do not know the column type at compile-time.
template<class ColumnType>
void | set_value (const TreeModelColumn<ColumnType>& column, const ColumnType& data) const
| Sets the value of this column of this row.

## Member Function Documentation

const TreeNodeChildren& Gtk::TreeRow::children | ( |  | ) | const

| This returns an STL-like container API, for iterating over the rows. See also Gtk::TreeModel::children() for the top-level children.

template <class ColumnType>
void Gtk::TreeRow::get_value | ( | int | column,
|  | ColumnType& | data
| ) | const

  | Use get_value(const TreeModelColumn<>& column) unless you do not know the column type at compile-time. If the data output argument is of an inappropriate C++ type then this might fail at runtime. Parameters:
  | column | The number of the column whose value you want to change.
Returns: data An output argument which will contain the value of this column of this row.

template <class ColumnType>
ColumnType Gtk::TreeRow::get_value | ( | const TreeModelColumn<ColumnType>& | column | ) | const

  | Gets the value of this column of this row. This is a templated method, so the compiler will not allow you to provide an inappropriate type of data for the model column. See also operator[]. Parameters:
  | column | The model column.
Returns: The new value to use for this column of this row.

const GtkTreeIter* Gtk::TreeRow::gobj | ( |  | ) | const`[inline]`

| Provides access to the underlying C GObject. Reimplemented from Gtk::TreeIterBase.

GtkTreeIter* Gtk::TreeRow::gobj | ( |  | ) | `[inline]`

| Provides access to the underlying C GObject. Reimplemented from Gtk::TreeIterBase.

Gtk::TreeRow::operator bool | ( |  | ) | const

| Discover whether this is a valid row. Reimplemented from Gtk::TreeIter.

template <class ColumnType>
TreeValueProxy<ColumnType> Gtk::TreeRow::operator[] | ( | const TreeModelColumn<ColumnType>& | column | ) | const`[inline]`

  | Use this to set and get the value of this column of this row. This is a templated method, so the compiler will not allow you to provide an inappropriate type of data for the model column. This is just a more convient syntax that does the same thing as set_value() and get_value(). Parameters:
  | column | The model column..

TreeIter Gtk::TreeRow::parent | ( |  | ) | const

| Gets an iterator to the parent row of this row. Returns: An iterator to the parent row.

template <class ColumnType>
void Gtk::TreeRow::set_value | ( | int | column,
|  | const ColumnType& | data
| ) | const

  | Use set_value(const TreeModelColumn<>& column, const ColumnType& data) unless you do not know the column type at compile-time. If the data is of an inappropriate C++ type then this might fail at runtime. Parameters:
  | column | The number of the column whose value you want to change.
  | data | The new value to use for this column of this row.

template <class ColumnType>
void Gtk::TreeRow::set_value | ( | const TreeModelColumn<ColumnType>& | column,
|  | const ColumnType& | data
| ) | const

  | Sets the value of this column of this row. This is a templated method, so the compiler will not allow you to provide an inappropriate type of data for the model column. See also operator[]. Parameters:
  | column | The model column.
  | data | The new value to use for this column of this row.

The documentation for this class was generated from the following file:

- treeiter.h