|  |  |  | AT-SPI C Bindings Reference Manual |  | 
|---|---|---|---|---|
| AccessibleApplication APIAccessibleApplication API — The interface implemented by the topmost Accessible in an application's hierarchy of Accessible objects. | 
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);
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.
void AccessibleApplication_ref (AccessibleApplication *obj);
Increment the reference count for an AccessibleApplication.
| 
 | a pointer to the AccessibleApplication on which to operate. | 
void AccessibleApplication_unref (AccessibleApplication *obj);
Decrement the reference count for an AccessibleApplication.
| 
 | a pointer to the AccessibleApplication object on which to operate. | 
char*               AccessibleApplication_getToolkitName
                                                        (AccessibleApplication *obj);
Get the name of the UI toolkit used by an AccessibleApplication.
| 
 | a pointer to the AccessibleApplication to query. | 
| Returns : | a UTF-8 string indicating which UI toolkit is used by an application. | 
char* AccessibleApplication_getVersion (AccessibleApplication *obj);
Get the version of the at-spi bridge exported by an AccessibleApplication instance.
| 
 | a pointer to the AccessibleApplication being queried. | 
| Returns : | a UTF-8 string indicating the application's at-spi version. | 
long AccessibleApplication_getID (AccessibleApplication *obj);
Get the unique ID assigned by the Registry to an AccessibleApplication instance. (Not Yet Implemented by the registry).
| 
 | 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. | 
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
| 
 | a pointer to the AccessibleApplication being queried. | 
| 
 | one of the POSIX LC_TYPE enumeration, for instance LC_MESSAGES. | 
| Returns : | a POSIX-compliant locale string, e.g. "C", "pt_BR", "sr latn", etc. | 
SPIBoolean AccessibleApplication_pause (AccessibleApplication *obj);
Attempt to pause the application (used when client event queue is over-full). Not Yet Implemented.
| 
 | a pointer to the Accessible object on which to operate. | 
| Returns : | TRUE if the application was paused successfully, FALSE otherwise. | 
SPIBoolean AccessibleApplication_resume (AccessibleApplication *obj);
Attempt to resume the application (used after AccessibleApplication_pause). Not Yet Implemented.
| 
 | a pointer to the Accessible object on which to operate. | 
| Returns : | TRUE if application processing resumed successfully, FALSE otherwise. |