databaseTreeView         package:RGtkViewers         R Documentation

_C_o_r_e _u_t_i_l_i_t_y _t_o _c_r_e_a_t_e _v_i_e_w _o_f _D_B_M_S _s_t_r_u_c_t_u_r_e

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

     These functions are the core for creating the 'GtkTree'  for
     displaying the structured hierarcy of a Relational Database
     Management Server (RDBMS). 'databaseTreeView' computes all the
     nodes before displaying the tree. 'databaseLazyTreeView' works
     lazily and only builds sub-trees when they are ``opened'' by the
     user. It does this by creating regular nodes for the top-level
     databases and then associating a callback with that node so that
     when it is expanded the next level of nodes are created and so on.

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

     databaseTreeView(con, callbacks = NULL, top = gtkTree(), databases = getDatabaes(con)[, 1], itemHandlers = NULL)
     databaseLazyTreeView(con, callbacks = NULL, top = gtkTree(), databases = getDatabases(con)[,1], itemHandlers = NULL)

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

     con: the database connection object. See 'dbConnect'.

callbacks: currently ignored.

     top: the (top-level) tree into which to put the databases. By
          specifying this here, one can merge the contents of two RDBMS
          into the same tree.

databases: a vector giving the names of the databases to include. This
          allows one to specify a subset of the available databases if
          one is not interested in the others

itemHandlers: a list of functions that are invoked at the different
          levels when the nodes in the tree are being created and these
          allow on to customize the behavior and appearance of the
          nodes. 

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

     A 'GtkTree' object.

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

     Duncan Temple Lang <duncan@research.bell-labs.com>

_R_e_f_e_r_e_n_c_e_s:

     <URL: http://www.omegahat.org/RGtk>, <URL:
     http://www.omegahat.org/RSDBI>,   <URL: http://www.gtk.org>

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

     'databaseView'

_E_x_a_m_p_l_e_s:

