AtkRegistry

AtkRegistry — An object used to store the GType of the factories used to create an accessible object for an object of a particular GType.

Synopsis

                    AtkRegistry;
void                atk_registry_set_factory_type       (AtkRegistry *registry,
                                                         GType type,
                                                         GType factory_type);
GType               atk_registry_get_factory_type       (AtkRegistry *registry,
                                                         GType type);
AtkObjectFactory *  atk_registry_get_factory            (AtkRegistry *registry,
                                                         GType type);
AtkRegistry *       atk_get_default_registry            (void);

Object Hierarchy

  GObject
   +----AtkRegistry

Description

The AtkRegistry is normally used to create appropriate ATK "peers" for user interface components. Application developers usually need only interact with the AtkRegistry by associating appropriate ATK implementation classes with GObject classes via the atk_registry_set_factory_type call, passing the appropriate GType for application custom widget classes.

Details

AtkRegistry

typedef struct _AtkRegistry AtkRegistry;

The AtkRegistry structure should not be accessed directly.


atk_registry_set_factory_type ()

void                atk_registry_set_factory_type       (AtkRegistry *registry,
                                                         GType type,
                                                         GType factory_type);

Associate an AtkObjectFactory subclass with a GType. Note: The associated factory_type will thereafter be responsible for the creation of new AtkObject implementations for instances appropriate for type.

registry :

the AtkRegistry in which to register the type association

type :

an AtkObject type

factory_type :

an AtkObjectFactory type to associate with type. Must implement AtkObject appropriate for type.

atk_registry_get_factory_type ()

GType               atk_registry_get_factory_type       (AtkRegistry *registry,
                                                         GType type);

Provides a GType indicating the AtkObjectFactory subclass associated with type.

registry :

an AtkRegistry

type :

a GType with which to look up the associated AtkObjectFactory subclass

Returns :

a GType associated with type type

atk_registry_get_factory ()

AtkObjectFactory *  atk_registry_get_factory            (AtkRegistry *registry,
                                                         GType type);

Gets an AtkObjectFactory appropriate for creating AtkObjects appropriate for type.

registry :

an AtkRegistry

type :

a GType with which to look up the associated AtkObjectFactory

Returns :

an AtkObjectFactory appropriate for creating AtkObjects appropriate for type.

atk_get_default_registry ()

AtkRegistry *       atk_get_default_registry            (void);

Gets a default implementation of the AtkObjectFactory/type registry. Note: For most toolkit maintainers, this will be the correct registry for registering new AtkObject factories. Following a call to this function, maintainers may call atk_registry_set_factory_type() to associate an AtkObjectFactory subclass with the GType of objects for whom accessibility information will be provided.

Returns :

a default implementation of the AtkObjectFactory/type registry