VDKTreeViewModel Class Reference

Provides a wrapper for GtkTreeModel basically it stores data to be viewed with a VDKTreeView. More...

#include <vdktreeview.h>

Inheritance diagram for VDKTreeViewModel:

List of all members.

Public Member Functions

• GtkTreeStore * GtkModel ()
• VDKTreeViewModel (GType *types, int ncol)
• ~VDKTreeViewModel ()
• void AppendBlank (GtkTreeIter *iter, GtkTreeIter *parent=NULL)
• void PrependBlank (GtkTreeIter *iter, GtkTreeIter *parent=NULL)
• void InsertTuple (GtkTreeIter *iter, VDKTreeViewModelTuple &tuple, GtkTreeIter *parent=NULL, bool recurse=false)
• void Clear ()
• void Remove (GtkTreeIter *i)
• void SetData (GtkTreeIter *node,...)
• void SetCell (GtkTreeIter *node, int column, const char *value)
• char * GetCell (GtkTreeIter *node, int column)
• void GetTuple (GtkTreeIter *node, VDKTreeViewModelTuple &tuple)
• bool HasChild ()
• void operator++ ()
• void operator++ (int)

---

Detailed Description

Provides a wrapper for GtkTreeModel basically it stores data to be viewed with a VDKTreeView.

---

Constructor & Destructor Documentation

VDKTreeViewModel::VDKTreeViewModel (  GType *  types, int  ncol )

constructor Parameters: types  a GType array ncol  the number of columns into the model

VDKTreeViewModel::~VDKTreeViewModel (   )

destructor

---

Member Function Documentation

void VDKTreeViewModel::AppendBlank (  GtkTreeIter *  iter, GtkTreeIter *  parent = NULL )

Appends a new blank tree row Parameters: iter  a not initialized iter address that will be filled with newly constructed tree row parent  if not NULL the row will appended as a child otherwise it will be appended as a sibling. TIP: appending all rows as sibling will degenerate the tree into a list GtkTreeIter iter; model->AppendBlank(); model->SetData(&iter,...);

void VDKTreeViewModel::Clear (   )

Clears the tree store

char * VDKTreeViewModel::GetCell (  GtkTreeIter *  node, int  column )

Get data from a cell, data type will be converted into their string representation accordlying with GType. Parameters: node  iterator to be retrieved column  cell column Supported GType's: G_TYPE_CHAR G_TYPE_STRING G_TYPE_BOOLEAN G_TYPE_INT G_TYPE_UINT G_TYPE_LONG G_TYPE_ULONG G_TYPE_FLOAT G_TYPE_DOUBLE Tip: Returned buffer address should be freed by user if not NULL. //signal response method bool TvForm::OnTreeViewSelectRow(VDKObject* sender) { // gets selections treeview->GetSelections(); // disregard multiple selections if(treeview->Selections().size() == 1) { VDKTreeViewModel* model = treeview->Model; // gets iter position from selections list GtkTreeIter iter = treeview->Selections()[0]; char* firstname = model->GetCell(&iter,0); // extract from iter position at column 0 char* lastname = model->GetCell(&iter,1); if(firstname && lastname) // GetCell() returns NULL on failure { printf("\n[%s %s]",firstname,lastname); fflush(stdout); delete[] firstname; delete[] lastname; } } treeview->Selections().flush(); return true; }

void VDKTreeViewModel::GetTuple (  GtkTreeIter *  node, VDKTreeViewModelTuple &  tuple )

Gets and fill a tuple with row data converted into their string representation Parameters: node  iterator to be retrieved tuple  a tuple reference (tuple can be empty since it will be resized and filled by the method

GtkTreeStore* VDKTreeViewModel::GtkModel (   )  [inline]

Return underlying GtkTreeStore object

bool VDKTreeViewModel::HasChild (   )

Move iterator to root node Parameters: iter  a not initialized iter address that will be filled with root node pointer GtkTreeIter iter; if(model->Root(&iter)) { char* cell = model->GetCell(&iter,0); if(cell) { // .. delete[] cell; } } */ bool Root(GtkTreeIter* iter); bool Next(GtkTreeIter* iter); bool HasChild(GtkTreeIter* iter) { return gtk_tree_model_iter_has_child (GTK_TREE_MODEL(model), iter); } bool Child(GtkTreeIter* iter,GtkTreeIter* parent); bool Find(GtkTreeIter* iter,int column, char* value); }; class VDKTreeViewModelIterator { VDKTreeViewModel* model; GtkTreeIter iter, *internal_iter; public: VDKTreeViewModelIterator(): model(NULL),internal_iter(NULL) {} VDKTreeViewModelIterator(VDKTreeViewModel* model,GtkTreeIter* parent = NULL); GtkTreeIter* current() { return internal_iter; } operator int() { return internal_iter != NULL; }

void VDKTreeViewModel::InsertTuple (  GtkTreeIter *  iter, VDKTreeViewModelTuple &  tuple, GtkTreeIter *  parent = NULL, bool  recurse = false )

Insert a tuple into model, tuple will be inserted in order. Parameters: iter  a not initialized iter address that will be filled with newly constructed tree row tuple  to be inserted parent  if is NULL tuple will be inserted in order into top level nodes list otherwise will be inserted in order into parent children list recurse  if true scans children/sibling list recursively to search insertion position

void VDKTreeViewModel::operator++ (  int   )

Incremental operator (infix), visit next sibling node

void VDKTreeViewModel::operator++ (   )

Incremental operator (postfix), visit next sibling node

void VDKTreeViewModel::PrependBlank (  GtkTreeIter *  iter, GtkTreeIter *  parent = NULL )

Prepends a new blank tree row Parameters: iter  a not initialized iter address that will be filled with newly constructed tree row parent  if not NULL the row will prepended as a child otherwise it will be prepended as a sibling. TIP: prepending all rows as sibling will degenerate the tree into a list GtkTreeIter iter; model->PrependBlank(); model->SetData(&iter,...);

void VDKTreeViewModel::Remove (  GtkTreeIter *  i  )

Removes the row at iter Parameters: i  the iter to be removed

void VDKTreeViewModel::SetCell (  GtkTreeIter *  node, int  column, const char *  value )

Sets data into a cell Parameters: node  the iterator to be set column  cell column value  a string representation of GType value that will be converted into a GType accordlying with the model GtkTreeIter *iter = model->PrependBlank(); model->SetCell(iter,0, "test"); model->SetCell(iter,1, "true"); Supported GType's: G_TYPE_CHAR G_TYPE_STRING G_TYPE_BOOLEAN G_TYPE_INT G_TYPE_UINT G_TYPE_LONG G_TYPE_ULONG G_TYPE_FLOAT G_TYPE_DOUBLE

void VDKTreeViewModel::SetData (  GtkTreeIter *  node,   ... )

Sets data into a row Parameters: node  the iterator to be set a  list of pairs <column ordinal number,type value> the list must be -1 terminated. GtkTreeIter iter; model->AppendBlank(); model->SetData(&iter, 0, "This is row 1", 1, FALSE, 2, NULL, -1);

---

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

• vdktreeview.h
• vdktreeview.cc

---