gtkObjectGetClasses          package:RGtk2          R Documentation

_D_y_n_a_m_i_c_a_l_l_y _C_o_m_p_u_t_e_s _c_l_a_s_s _i_n_f_o_r_m_a_t_i_o_n

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

     *DEPRECATED!! (compatibility wrappers for RGtk 1!)* 

     These functions dynamically compute information about the class
     hierarchy for a given Gtk object or a type. The class hierarchy is
     defined by the C-level Gtk code and is ``reflected'' to S via
     these functions. Most S-level Gtk objects will be created in the
     RGtk package with the appropriate class. In cases where this is
     not true, 'gtkObjectGetClass' can be used to compute and assign
     the appropriate class so that the regular S interface for that
     object will work.

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

     gtkObjectGetClasses(w, check=TRUE)
     gtkObjectGetTypeName(w)
     gtkTypeGetClasses(type)

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

       w: the Gtk object whose class information is to be computed.

    type: an S object identifying the Gtk type of interest. This can be
          either a character string giving the name of the type or an
          object of class 'GtkType'

   check: a logical value that can be used to bypass a check that the
          argument 'w' is of class 'GtkObject'. If the object has not
          class information but the caller knows that it is a pointer
          to a Gtk object, then to compute the class conveniently,
          'check' can be passed as 'FALSE'.

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

     This uses C code to query the internal Gtk class hierarchy. The
     class information is not (only) S class information, but mirrors
     the real Gtk class hieararchy.

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

     A character vector. 'gtkObjectGetTypeName' returns the name of the
     class/type of the given object. 'gtkObjectGetClasses' and
     'gtkTypeGetClasses' return the names of the object class/type and
     its successive parent classes, up to  'GtkObject'.

_N_o_t_e:

     THIS STUFF IS VERY OLD AND DEPRECATED (compatibility wrappers for
     RGtk 1)

     Type information about a particular class is not available until
     that class has been initialized. One can call the C routine
     'gtk_<type-name>_get_type' to initialize it or, more commonly and
     completely, create an instance of that class. So
     '.C("gtk_button_get_type", PACKAGE = "RGtk")' or 'gtkButton()'
     should preceed 'gtkTypeGetClasses("GtkButton")'

_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:

     Information on the package is available from <URL:
     http://www.omegahat.org/RGtk>.

     Information on Gtk is available from <URL: http://www.gtk.org>.

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

     'gtkObjectGetSignals' 'gtkTypeGetSignals'

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

       if (gtkInit()) {
         b <- gtkButton()
         class(b)

          # Should be true
         class(b) == gtkObjectGetClasses(b)
       }

