Accessible

Instances of this class provide a bridge between application code and assistive technology clients. Many platforms provide default accessible behavior for most widgets, and this class allows that default behavior to be overridden. Applications can get the default Accessible object for a control by sending it <code>getAccessible</code>, and then add an accessible listener to override simple items like the name and help string, or they can add an accessible control listener to override complex items. As a rule of thumb, an application would only want to use the accessible control listener to implement accessibility for a custom control.

@see Control#getAccessible @see AccessibleListener @see AccessibleEvent @see AccessibleControlListener @see AccessibleControlEvent @see <a href="http://www.eclipse.org/swt/snippets/#accessibility">Accessibility snippets</a> @see <a href="http://www.eclipse.org/swt/">Sample code and further information</a>

@since 2.0

Members

Functions

addAccessibleControlListener
void addAccessibleControlListener(AccessibleControlListener listener)

Adds the listener to the collection of listeners who will be notified when an accessible client asks for custom control specific information. The listener is notified by sending it one of the messages defined in the <code>AccessibleControlListener</code> interface.

addAccessibleListener
void addAccessibleListener(AccessibleListener listener)

Adds the listener to the collection of listeners who will be notified when an accessible client asks for certain strings, such as name, description, help, or keyboard shortcut. The listener is notified by sending it one of the messages defined in the <code>AccessibleListener</code> interface.

addAccessibleTextListener
void addAccessibleTextListener(AccessibleTextListener listener)

Adds the listener to the collection of listeners who will be notified when an accessible client asks for custom text control specific information. The listener is notified by sending it one of the messages defined in the <code>AccessibleTextListener</code> interface.

getControl
Control getControl()

Returns the control for this Accessible object.

removeAccessibleControlListener
void removeAccessibleControlListener(AccessibleControlListener listener)

Removes the listener from the collection of listeners who will be notified when an accessible client asks for custom control specific information.

removeAccessibleListener
void removeAccessibleListener(AccessibleListener listener)

Removes the listener from the collection of listeners who will be notified when an accessible client asks for certain strings, such as name, description, help, or keyboard shortcut.

removeAccessibleTextListener
void removeAccessibleTextListener(AccessibleTextListener listener)

Removes the listener from the collection of listeners who will be notified when an accessible client asks for custom text control specific information.

selectionChanged
void selectionChanged()

Sends a message to accessible clients that the child selection within a custom container control has changed.

setFocus
void setFocus(int childID)

Sends a message to accessible clients indicating that the focus has changed within a custom control.

textCaretMoved
void textCaretMoved(int index)

Sends a message to accessible clients that the text caret has moved within a custom control.

textChanged
void textChanged(int type, int startIndex, int length)

Sends a message to accessible clients that the text within a custom control has changed.

textSelectionChanged
void textSelectionChanged()

Sends a message to accessible clients that the text selection has changed within a custom control.

Static functions

internal_new_Accessible
Accessible internal_new_Accessible(Control control)

Invokes platform specific functionality to allocate a new accessible object. <p> <b>IMPORTANT:</b> This method is <em>not</em> part of the public API for <code>Accessible</code>. It is marked public only so that it can be shared within the packages provided by SWT. It is not available on all platforms, and should never be called from application code. </p>

Meta