GtkObject

GtkObject — the fundamental Gtk parent class.

Synopsis

class GtkObject 
{
    _callbacks; 
    _exceptions; 
    flags; 
    object_signal;              // GtkSignal : Write 
    object_signal_after;        // GtkSignal : Write 
    signal;                     // GtkSignal : Write 
    signal_after;               // GtkSignal : Write 
    user_data;                  // gpointer  : Read / Write 
}
     

Child Classes

GtkData GtkItemFactory GtkWidget

Description

Four of the methods for this class bear further explanation.

GtkObject.get  takes a list of attribute name strings, and returns a list of cons pairs of the name and the corresponding value, like so:

((name . value)...)

GtkObject.set takes a list of cons of attribute name strings and new values in the format shown above, assigns the values to the names, and returns that same list.

[Important]

The getv and setv methods are deprecated in Gamma/GTK because they will delete instance variables used by Gamma/GTK. These methods will process only instance variables that are available in the standard GTK library, whereas Gamma/GTK adds an additional layer of instance variables to circumvent certain limitations in GTK. The getv and setv methods are included for completeness, but are deprecated in favour of the instance.attribute form in Gamma.

GtkObject.getv takes a list of GtkArg, where GtkArg.name is set to the desired attribute. If the attribute is available in the standard GTK library, then the value is set in the GtkArg.d element, otherwise the GtkArg item is deleted from the list.

GtkObject.setv takes a similar list, with the same return (including deletion of list items referencing unstandard attributes). In theory, the GtkArg.d should be set to the new desired value, but right now there is a problem in that you cannot assign to it. You can set the element with getv if it is an instance, then modify its sub-elements before re-submitting it with setv.

Methods

arg_get (arg, info)
arg_set (arg, info)
constructed ()
default_construct ()
destroy ()
event (name, action)
event_after (name, action)
get (resource_name_list)
getv (n_args, args)
ref ()
remove_data (key)
remove_no_notify (key)
set (resource_, (name.value), _list)
setv (n_args, args)
signal (name, action)
signal_after (name, action)
signal_emit_by_name (name, args)
signal_emit_stop_by_name (name)
sink ()
unref ()

Related Functions

gtk_object_add_arg_type (arg_name, arg_type, arg_flags, arg_id)
gtk_object_arg_get_info (gtk_type, arg_name)
gtk_object_get_type () -- replaces GTK_TYPE_OBJECT
gtk_object_newv (object_type, n_args, args)
gtk_trace_referencing (object, func, dummy, line, do_ref)