custom-tree-models           package:RGtk2           R Documentation

_C_u_s_t_o_m _G_t_k_T_r_e_e_M_o_d_e_l _i_m_p_l_e_m_e_n_t_a_t_i_o_n_s

_D_e_s_c_r_i_p_t_i_o_n:

     Functions that allow one to implement a custom 'GtkTreeModel'

_U_s_a_g_e:

       gtkTreeIter(id, stamp)
       gtkTreeIterGetId(iter)
       gtkTreeIterSetId(iter, id)
       gtkTreeIterGetStamp(iter)
       gtkTreeIterSetStamp(iter, stamp)

_A_r_g_u_m_e_n_t_s:

    iter: The 'GtkTreeIter' of a custom model

      id: The integer code identifying 'iter'

   stamp: The integer code for tracking the version of 'iter'

_D_e_t_a_i_l_s:

     These functions allow one to create and access 'GtkTreeIter'
     structures when implementing a 'GtkTreeModel'.

     'gtkTreeIter' creates an iter from scratch, given an id and stamp.

     'gtkTreeIterGetId' and 'gtkTreeIterSetId' access the integer that
     identifies the data element referred to by 'iter'.

     'gtkTreeIterGetStamp' and 'gtkTreeIterSetStamp' access the integer
     that serves as a version stamp. After the model changes, the model
     version should be incremented, so that all existing iters are
     invalidated, as evidenced by their stamp.

_V_a_l_u_e:

     For 'gtkTreeIter', an external pointer to the underlying C
     structure.

     For 'gtkTreeIterGetId', the integer code identifying the element
     referred to by 'iter'.

     For 'gtkTreeIterGetStamp', the integer code identifying the
     version of 'iter'.

_N_o_t_e:

     These functions are for implementing 'GtkTreeModel's only! Most of
     the time, one can use one of the implementations included with
     GTK+  ('GtkListStore' or 'GtkTreeStore') or 'RGtkDataFrame'.

_A_u_t_h_o_r(_s):

     Michael Lawrence

_S_e_e _A_l_s_o:

     gClass

