gtkTreeRowReferenceNewProxy      package:RGtk2      R Documentation

_g_t_k_T_r_e_e_R_o_w_R_e_f_e_r_e_n_c_e_N_e_w_P_r_o_x_y

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

     You do not need to use this function.  Creates a row reference
     based on 'path'.  This reference will keep pointing to the node
     pointed to by 'path',  so long as it exists.  If 'path' isn't a
     valid path in 'model', then 'NULL' is returned.  However, unlike
     references created with 'gtkTreeRowReferenceNew', it does not
     listen to the model for changes. The creator of the row reference
     must do this explicitly using 'gtkTreeRowReferenceInserted',
     'gtkTreeRowReferenceDeleted', 'gtkTreeRowReferenceReordered'.

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

     gtkTreeRowReferenceNewProxy(proxy, model, path)

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

 'proxy': ['GObject']  A proxy 'GObject'

 'model': ['GtkTreeModel']  A 'GtkTreeModel'

  'path': ['GtkTreePath']  A valid 'GtkTreePath' to monitor

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

     These functions must be called exactly once per proxy when the
     corresponding signal on the model is emitted. This single call
     updates all row references for that proxy. Since built-in GTK+
     objects like 'GtkTreeView' already use this mechanism internally,
     using them as the proxy object will produce unpredictable results.
     Further more, passing the same object as 'model' and 'proxy'
     doesn't work for reasons of internal implementation.

     This type of row reference is primarily meant by structures that
     need to carefully monitor exactly when a row reference updates
     itself, and is not generally needed by most applications.

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

     ['GtkTreeRowReference']  A newly allocated 'GtkTreeRowReference',
     or 'NULL'

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

     Derived by RGtkGen from GTK+ documentation

