AccessibleApplication API

AccessibleApplication API — The interface implemented by the topmost Accessible in an application's hierarchy of Accessible objects.

Synopsis

void                AccessibleApplication_ref           (AccessibleApplication *obj);
void                AccessibleApplication_unref         (AccessibleApplication *obj);
char *              AccessibleApplication_getToolkitName
                                                        (AccessibleApplication *obj);
char *              AccessibleApplication_getVersion    (AccessibleApplication *obj);
long                AccessibleApplication_getID         (AccessibleApplication *obj);
char *              AccessibleApplication_getLocale     (AccessibleApplication *obj,
                                                         int lc_category);
SPIBoolean          AccessibleApplication_pause         (AccessibleApplication *obj);
SPIBoolean          AccessibleApplication_resume        (AccessibleApplication *obj);

Description

This interface is implemented on the topmost object in an application's hierarchy. It is primarily a marker interface, though certain properties associated with an application, such as the application's current default locale, are also exposed.

Details

AccessibleApplication_ref ()

void                AccessibleApplication_ref           (AccessibleApplication *obj);

Increment the reference count for an AccessibleApplication.

obj :

a pointer to the AccessibleApplication on which to operate.

AccessibleApplication_unref ()

void                AccessibleApplication_unref         (AccessibleApplication *obj);

Decrement the reference count for an AccessibleApplication.

obj :

a pointer to the AccessibleApplication object on which to operate.

AccessibleApplication_getToolkitName ()

char *              AccessibleApplication_getToolkitName
                                                        (AccessibleApplication *obj);

Get the name of the UI toolkit used by an AccessibleApplication.

obj :

a pointer to the AccessibleApplication to query.

Returns :

a UTF-8 string indicating which UI toolkit is used by an application.

AccessibleApplication_getVersion ()

char *              AccessibleApplication_getVersion    (AccessibleApplication *obj);

Get the version of the UI toolkit used by an AccessibleApplication instance.

obj :

a pointer to the AccessibleApplication being queried.

Returns :

a UTF-8 string indicating the version of the UI toolkit which is used by an application.

AccessibleApplication_getID ()

long                AccessibleApplication_getID         (AccessibleApplication *obj);

Get the unique ID assigned by the Registry to an AccessibleApplication instance. (Not Yet Implemented by the registry).

obj :

a pointer to the AccessibleApplication being queried.

Returns :

a unique long integer associated with the application by the Registry, or 0 if the application is not registered.

AccessibleApplication_getLocale ()

char *              AccessibleApplication_getLocale     (AccessibleApplication *obj,
                                                         int lc_category);

Get a POSIX-compliant string describing the application's current locale setting for a particular lctype category.

Since: AT-SPI 1.4

obj :

a pointer to the AccessibleApplication being queried.

lc_category :

one of the POSIX LC_TYPE enumeration, for instance LC_MESSAGES.

Returns :

a POSIX-compliant locale string, e.g. "C", "pt_BR", "srlatn", etc.

AccessibleApplication_pause ()

SPIBoolean          AccessibleApplication_pause         (AccessibleApplication *obj);

Attempt to pause the application (used when client event queue is over-full). Not Yet Implemented.

obj :

a pointer to the Accessible object on which to operate.

Returns :

TRUE if the application was paused successfully, FALSE otherwise.

AccessibleApplication_resume ()

SPIBoolean          AccessibleApplication_resume        (AccessibleApplication *obj);

Attempt to resume the application (used after AccessibleApplication_pause). Not Yet Implemented.

obj :

a pointer to the Accessible object on which to operate.

Returns :

TRUE if application processing resumed successfully, FALSE otherwise.