X-Git-Url: http://review.tizen.org/git/?p=platform%2Fcore%2Fuifw%2Fat-spi2-atk.git;a=blobdiff_plain;f=xml%2Forg.freedesktop.atspi.Registry.xml;h=9abced17032ceb62987d28156ace86e22125d1cc;hp=b4543856ab659ca64391050b776aa5e29e8370ff;hb=36a4131a9cc9fc8d474058d2a9448bc9eac91f17;hpb=540b46a2589d27ba52e45eee8c2b0a21265799c5
diff --git a/xml/org.freedesktop.atspi.Registry.xml b/xml/org.freedesktop.atspi.Registry.xml
index b454385..9abced1 100644
--- a/xml/org.freedesktop.atspi.Registry.xml
+++ b/xml/org.freedesktop.atspi.Registry.xml
@@ -1,177 +1,85 @@
- This library is free software; you can redistribute it and/or
- modify it under the terms of the GNU Library General Public
- License as published by the Free Software Foundation; either
- version 2 of the License, or (at your option) any later version. This library is distributed in the hope that it will be useful,
- but WITHOUT ANY WARRANTY; without even the implied warranty of
- MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
- Library General Public License for more details. You should have received a copy of the GNU Library General Public
- License along with this library; if not, write to the
- Free Software Foundation, Inc., 59 Temple Place - Suite 330,
- Boston, MA 02111-1307, USA. 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
+ 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:
- \li it provides a list of the applications who have registered with the AT-SPI
- framework, thereby announcing their participation in the AT-SPI framework;
- \li it allows AT clients to register for notification of changes in application
- state (at-spi Events);
- \li it dispatches/relays said events from participating applications to
- the registered listeners;
- \li it gives access to system device events via the associated DeviceEventController
- interface.
+
+
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.
-@note Although all application events are dispatched via the Registry, other AT client +
Although all application events are dispatched via the Registry, other AT client calls are serviced directly by the applications, rather than being relayed via the Registry. The AT client obtains references to these application objects via the enumeration of Desktop instances whose children are Application instances - (Registry::getDesktopList) and via examination of the 'source' member of the Event + (Registry.getDesktopList) and via examination of the 'source' member of the Event structure.
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. - @image html "http://developer.gnome.org/projects/gap/tech-docs/SPIBlockDiagram.png"
- -@see Desktop, Application, Event, EventListener
+ illustrating the relationship between applications, Registry, and AT is shown at: + http://developer.gnome.org/projects/gap/tech-docs/SPIBlockDiagram.png -De-register an application previously registered with the broker. - deregisterApplication:
-Register a client's interest in (all) application events of - a certain type.
-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.
-getDesktop: - @n: the index of the requested Desktop.
-Get the nth accessible desktop.
-Get a list of accessible desktops.
-Obtain an object which can be used to request device event notifications.
-