GtkObject

Gamma/GTK: Using Gamma™ with GTK, Version 0.9
Prev |  | Next

# `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.

| 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`)
`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`)

Prev | Home | Next
`GtkNotebookPage` | Up | `GtkPackerChild`

Copyright 1995-2002 by Cogent Real-Time Systems, Inc.