import "Accessibility_Registry.idl";
Public Member Functions | |
oneway void | registerApplication (in Application app) |
void | deregisterApplication (in Application app) |
void | registerGlobalEventListener (in EventListener listener, in string eventName) |
void | deregisterGlobalEventListenerAll (in EventListener listener) |
void | deregisterGlobalEventListener (in EventListener listener, in string eventName) |
short | getDesktopCount () |
Desktop | getDesktop (in short n) |
DesktopSeq | getDesktopList () |
DeviceEventController | getDeviceEventController () |
The Registry is a service through which applications providing accessibility services (servers) can rendezvous with consumers of those services (Assistive Technologies). The Registry is the first "port of call" for accessible applications and for assistive technologies wishing to query and interact with those applications.
The Registry service provides four basic functions to Assistive Technology (AT) clients:
From the point of view of accessible applications (i.e. AT-SPI service producers), the Registry is primarily a registration and event delivery service. Applications normally only call the registerApplication and deregisterApplication Registry methods, and its inherited EventListener::notifyEvent method.
The Registry normally lives in its own process space; communication via Registry and both application services and AT clients takes place via IPC. A process space diagram illustrating the relationship between applications, Registry, and AT is shown below.
void Accessibility::Registry::deregisterApplication | ( | in Application | app | ) |
De-register an application previously registered with the broker. deregisterApplication:
app,: | a reference to the Application to be deregistered. |
void Accessibility::Registry::deregisterGlobalEventListener | ( | in EventListener | listener, | |
in string | eventName | |||
) |
deregisterGlobalEventListener:
listener,: | the requesting EventListener | |
eventName,: | a string indicating the type of events |
Request that a previously registered client stop receiving global notifications for events of a certain type.
void Accessibility::Registry::deregisterGlobalEventListenerAll | ( | in EventListener | listener | ) |
deregisterGlobalEventListenerAll:
listener,: | the requesting EventListener |
Request that a previously registered client stop receiving global notifications for all events for which it was registered.
Desktop Accessibility::Registry::getDesktop | ( | in short | n | ) |
short Accessibility::Registry::getDesktopCount | ( | ) |
event types: "Window" "Desktop" "Window:Create" "Window:Destroy" "Window:Iconify" "Window:Restore" "Window:Fullscreen" "Window:Resize" "Desktop:Create" "Desktop:Destroy" "Desktop:Focus" "Desktop:Defocus" "Desktop:Reorder" "Focus" "GtkWidget:show" "GObject:notify:<propertyname>"
( not sure we should allow these last 2 forms, since they are toolkit-specific, but they're powerful ) getDesktopCount:
Get the current number of desktops.
DesktopSeq Accessibility::Registry::getDesktopList | ( | ) |
Get a list of accessible desktops.
DeviceEventController Accessibility::Registry::getDeviceEventController | ( | ) |
Obtain an object which can be used to request device event notifications.
oneway void Accessibility::Registry::registerApplication | ( | in Application | app | ) |
Register a new application with the accessibility broker.
app,: | a reference to the requesting Application |
void Accessibility::Registry::registerGlobalEventListener | ( | in EventListener | listener, | |
in string | eventName | |||
) |
Register a client's interest in (all) application events of a certain type.
listener,: | a reference to the requesting EventListener. | |
eventName,: | a string which indicates the type of events about which the client desires notification. |