net.rim.device.api.ui.accessibility
Class AccessibilityManager

java.lang.Object
  net.rim.device.api.ui.accessibility.AccessibilityManager

public final class AccessibilityManager
extends Object

Provides listener registration methods for assistive technology

Category:

Signed: This element is only accessible by signed applications. If you intend to use this element, please visit http://www.blackberry.com/go/codesigning to obtain a set of code signing keys. Code signing is only required for applications running on BlackBerry smartphones; development on BlackBerry Smartphone Simulators can occur without code signing.

Since:

BlackBerry API 4.6.1

Method Summary
	static boolean	isAccessibilitySupported() Checks whether accessibility is supported on this device.
	static boolean	isAccessibleEventListenerRegistered() Checks whether an assistive technology is already registered.
	static void	removeAccessibleEventListener(AccessibleEventListener listener) Unregister accessible event listener.
	static void	setAccessibleEventListener(AccessibleEventListener listener) Registers accessible event listener.

Methods inherited from class java.lang.Object

equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Method Detail

isAccessibilitySupported

public static boolean isAccessibilitySupported()

Checks whether accessibility is supported on this device. If accessibility is not supported then there are no means to discover visual elements and listen for their updates. A call to AccessibilityManager.setAccessibleEventListener(AccessibleEventListener) method would throw an UnsupportedOperationException.

This method may be used by screen reader before registration or by other applications to optimize accessible model building operations.

Returns:

true if supported, false otherwise

Category:

Signed: This element is only accessible by signed applications. If you intend to use this element, please visit http://www.blackberry.com/go/codesigning to obtain a set of code signing keys. Code signing is only required for applications running on BlackBerry smartphones; development on BlackBerry Smartphone Simulators can occur without code signing.

Since:

BlackBerry API 5.0.0

setAccessibleEventListener

public static void setAccessibleEventListener(AccessibleEventListener listener)
                                       throws UnsupportedOperationException

Registers accessible event listener. This method is called by an assistive technology to receive notifications about UI components changes.

Parameters:

listener - assistive technology application

Throws:

UnsupportedOperationException - if accessibility is not supported on this device

Category:

Signed: This element is only accessible by signed applications. If you intend to use this element, please visit http://www.blackberry.com/go/codesigning to obtain a set of code signing keys. Code signing is only required for applications running on BlackBerry smartphones; development on BlackBerry Smartphone Simulators can occur without code signing.

Since:

BlackBerry API 4.6.1

removeAccessibleEventListener

public static void removeAccessibleEventListener(AccessibleEventListener listener)
                                          throws UnsupportedOperationException

Unregister accessible event listener.

Parameters:

listener - assistive technology application

Throws:

UnsupportedOperationException - if accessibility is not supported on this device

Category:

Signed: This element is only accessible by signed applications. If you intend to use this element, please visit http://www.blackberry.com/go/codesigning to obtain a set of code signing keys. Code signing is only required for applications running on BlackBerry smartphones; development on BlackBerry Smartphone Simulators can occur without code signing.

Since:

BlackBerry API 4.6.1

isAccessibleEventListenerRegistered

public static boolean isAccessibleEventListenerRegistered()

Checks whether an assistive technology is already registered.

Returns:

true if registered false otherwise

Category:

Signed: This element is only accessible by signed applications. If you intend to use this element, please visit http://www.blackberry.com/go/codesigning to obtain a set of code signing keys. Code signing is only required for applications running on BlackBerry smartphones; development on BlackBerry Smartphone Simulators can occur without code signing.

Since:

BlackBerry API 4.6.1