gtkSignalGetInfo            package:RGtk2            R Documentation

_R_e_f_l_e_c_t_a_n_c_e _i_n_f_o_r_m_a_t_i_o_n _a_b_o_u_t _a _G_t_k _s_i_g_n_a_l

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

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

     This returns information about the Gtk signal of interest, giving
     details such as the number and type of parameters that are passed
     to a signal handler function registered for an event associated
     with this signal; the type of the return value expected from the
     handler; the class for which it is defined; the flags indicating
     how and when handlers for this signal are invoked when an event
     occurs;

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

     gtkSignalGetInfo(sig)

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

     sig: an object of class 'GtkSignalId', typically obtained from a
          call to 'gtkTypeGetSignals'

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

     This uses the C-level reflectance mechanism provided by Gtk to
     obtain information about a particular signal registered via the
     class mechanism. This information is then converted to an S
     object.

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

     A list with 6 elements 

  signal: the 'GtkSignalId' object ('sig') used to identify the signal
          in the call

parameters: a named list of parameter types that are passed to a
          callback/signal handler for this signal. Each element is a
          'GtkType' object identifying the particular type of that
          argument. The names are intended to give some indication of
          their meaning. Note that this list does not include the
          object for which the event is generated and which is included
          in all signal handler calls.

returnType: the 'GtkType' object identifying the type of the value a
          handler should return.

isUserSignal: a logical value indicating whether this is a user-defined
          signal or built-in signal

runFlags: a value giving information about how and when the handlers
          are invoked in response to this signal. This is a single
          value made up of OR'ing values from the '.GtkSignalRunType'
          vector. See the possible values there. One rarely needs to
          understand this information to use a signal handler function. 

objectType: an object of class 'GtkType' identifying the Gtk class/type
          for which the signal is defined.

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

     'gtkTypeGetSignals' 'getSignalInfo'

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

       if (gtkInit()) {
         gtkButton()
         sigs <- gtkTypeGetSignals("GtkButton")
         gtkSignalGetInfo(sigs[["clicked"]])
       }

