org.eclipse.actf.accservice.core.win32.msaa
Class MsaaAccessibilityService

java.lang.Object
  extended by org.eclipse.actf.accservice.core.win32.msaa.MsaaAccessibilityService
All Implemented Interfaces:
Serializable, IAccessibilityService
Direct Known Subclasses:
IA2AccessibilityService

public class MsaaAccessibilityService
extends Object
implements IAccessibilityService

See Also:
Serialized Form

Field Summary
static String ACTF_MSAA_LIBRARY_NAME
          name of dynamic module for MSAA access; value is 'actf-msaa'
static String MSAA_ACCSERVICE_NAME
          accessibility service name for this service; value is 'msaa'
 
Constructor Summary
MsaaAccessibilityService()
           
 
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.
protected static boolean internalCoInitialize()
           
protected static boolean internalCoUnInitialize()
           
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

Field Detail

ACTF_MSAA_LIBRARY_NAME

public static final String ACTF_MSAA_LIBRARY_NAME
name of dynamic module for MSAA access; value is 'actf-msaa'

See Also:
Constant Field Values

MSAA_ACCSERVICE_NAME

public static final String MSAA_ACCSERVICE_NAME
accessibility service name for this service; value is 'msaa'

See Also:
Constant Field Values
Constructor Detail

MsaaAccessibilityService

public MsaaAccessibilityService()
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

internalCoInitialize

protected static boolean internalCoInitialize()

internalCoUnInitialize

protected static boolean internalCoUnInitialize()