signalInfo: Reflectance information about a Gtk signal

In RGtk2: R Bindings for Gtk 2.8.0 and Above

Description

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;

Usage

gtkSignalGetInfo(sig)

Arguments

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

Details

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.

Value

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.

Author(s)

Duncan Temple Lang <[e-mail]>

References

Information on the package is available from http://www.omegahat.net/RGtk.

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

See Also

gtkTypeGetSignals getSignalInfo

Examples

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

RGtk2 documentation built on Oct. 14, 2021, 5:08 p.m.