org.eclipse.actf.accservice.javapp
Class JavaAccessibilityService

java.lang.Object
  extended by org.eclipse.actf.accservice.javapp.JavaAccessibilityService
All Implemented Interfaces:
Serializable, IAccessibilityService

public class JavaAccessibilityService
extends Object
implements IAccessibilityService

Author:
wscarter
See Also:
Serialized Form

Field Summary
static String JAVA_ACCSERVICE_NAME
          accessibility service name for this service; value is 'jaapi'
 
Fields inherited from interface org.eclipse.actf.accservice.IAccessibilityService
serialVersionUID
 
Constructor Summary
JavaAccessibilityService()
           
 
Method Summary
 IAccessibleElement createAccessibleElement(Object obj, Object[] params)
          create an IAccessibleElement from the given object and optional parameters.
 IAccessibilityEventService getAccessibilityEventService()
          retreaves the event services for the underlying accessibility infrastructure.
 IWindowService getWindowService()
          returns a service for windowing-related functionality.
 void initialize()
          initialize the service by loading native libraries, configuring platform-specific resources, and the like.
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

Field Detail

JAVA_ACCSERVICE_NAME

public static final String JAVA_ACCSERVICE_NAME
accessibility service name for this service; value is 'jaapi'

See Also:
Constant Field Values
Constructor Detail

JavaAccessibilityService

public JavaAccessibilityService()
Method Detail

createAccessibleElement

public IAccessibleElement createAccessibleElement(Object obj,
                                                  Object[] params)
                                           throws InvalidComponentException
Description copied from interface: IAccessibilityService
create an IAccessibleElement from the given object and optional parameters. IAccessibleElement instances are used to access accesibility-related properties of the given object and need not (and, in most cases, are not) the same object as the given object.

Specified by:
createAccessibleElement in interface IAccessibilityService
Parameters:
obj - object for which an accessible is desired
params - optional parameters for creating the accessible (may be null)
Returns:
an IAccessibleElement for the given object
Throws:
InvalidComponentException - if the given object is somehow invalid or an accessible cannot b created for the given object

getAccessibilityEventService

public IAccessibilityEventService getAccessibilityEventService()
Description copied from interface: IAccessibilityService
retreaves the event services for the underlying accessibility infrastructure. The IAccessibilityEventService allows clients to register event listeners to listen for low-level, platform-specific events that are used by accessibility devices (like assistive technologies).

Specified by:
getAccessibilityEventService in interface IAccessibilityService
Returns:
the IAccessibilityEventService object for this accessibility infrastructure or null if no such event service is available

getWindowService

public IWindowService getWindowService()
Description copied from interface: IAccessibilityService
returns a service for windowing-related functionality. This includes getting the top-level windows of whatever the platform considers to be its desktop, adding listeners to observe creation and destruction of top-level windows, and getting the active or current window.

Specified by:
getWindowService in interface IAccessibilityService
Returns:
windowing service for this platform or null if no such service exists

initialize

public void initialize()
                throws AccessibilityServiceException
Description copied from interface: IAccessibilityService
initialize the service by loading native libraries, configuring platform-specific resources, and the like. This method will be called by the service manager upon instantiating the service.

Specified by:
initialize in interface IAccessibilityService
Throws:
AccessibilityServiceException