X-Git-Url: http://review.tizen.org/git/?a=blobdiff_plain;f=idl%2FApplication.idl;h=b921af678d65b0af1f95126a444ac6f3156b875e;hb=fd46827d0ef868929e7c255334b73adf2e305a85;hp=6ecd658bc7f011f359f38b13bc5657e2dc006779;hpb=ee75de39f4e8247f694b328163fc974ba791305f;p=platform%2Fcore%2Fuifw%2Fat-spi2-atk.git diff --git a/idl/Application.idl b/idl/Application.idl index 6ecd658..b921af6 100644 --- a/idl/Application.idl +++ b/idl/Application.idl @@ -23,14 +23,15 @@ #ifndef __ACCESSIBILITY_APPLICATION_DEFINED__ #define __ACCESSIBILITY_APPLICATION_DEFINED__ -#include +#include #include module Accessibility { interface Application : Accessible { /** - * Get a string indicating the type of user interface toolkit + * @toolkitName: + * A string indicating the type of user interface toolkit * which is used by the application. * Ordinarily clients of @AccessibleApplication should be * toolkit-agnostic, dependencies on this method probably @@ -39,33 +40,63 @@ module Accessibility { readonly attribute string toolkitName; /** - * Get a string indicating the version number of the application's + * @version: + * A string indicating the version number of the application's * accessibility bridge implementation. **/ readonly attribute string version; /** - * Get the application instance's unique ID as assigned by the registry. + * @id: + * The application instance's unique ID as assigned by the registry. + **/ + attribute long id; + + /** + * registerToolkitEventListener: + * @listener: an #EventListener object which will receive the requested + * events from the application's toolkits via toolit 'bridges' + * @eventName: a UTF-8 string indicating the type of (toolkit-specific) event + * being requested. Not all applications can generate toolkit events of + * a given type. + * + * Register with this application's toolkit for "toolkit-specific" event notifications. + * For most event support, clients should use non-toolkit-specific events + * whenever possible, via #Registry::registerGlobalEventListener - this method + * is provided as a 'back door' when generic names do not exist for the events in question. + * SUBJECT TO DEPRECATION in favor of Registry::registerGlobalEventListener forms. + * + **/ + void registerToolkitEventListener (in EventListener listener, in string eventName); + + /** + * registerObjectEventListener: + * @listener: an #EventListener object which will receive the requested + * events + * @eventName: a UTF-8 string indicating the type of (toolkit-specific) event + * being requested. + * Register with this application toolkit for "Accessibility::Accessible" + * event notifications. SUBJECT TO DEPRECATION * **/ - attribute string id; + void registerObjectEventListener (in EventListener listener, in string eventName); /** * pause: - * Returns: %true if the request succeeded, %false otherwise. * * Request that the application temporarily stop sending events. * In most cases this should pause the application's main event loop. * + * Returns: %true if the request succeeded, %false otherwise. **/ boolean pause (); /** * resume: - * Returns: %true if the request succeeded, %false otherwise. * * Request that the application resume sending events. * + * Returns: %true if the request succeeded, %false otherwise. **/ boolean resume (); };