最近由于項目的需要，研究了一下SWT的Accessibility。關于Accessibility，這是一個很難纏的search，給殘疾人用的東東，正常人基本上不會用到，網上文章少之又少。可以查閱到的一篇來自于IBM developerWorks的文章：使用 Eclipse 創建易訪問的應用程序：介紹
易訪問性是一個總括的術語，它包括生成使具有各種殘疾的人易用的產品所涉及的所有東西和人。美國已經立法，不符合Accessibility規范的軟件不能夠在政府部門銷售。在美國，創建易訪問的應用程序的主要商業（對比人道主義）驅動力是 Rehabilitation Act 1998 年的修正法案，稱為 Section 508。Section 508 要求聯邦機構使他們的信息技術對帶有殘疾的人易于訪問。
Eclipse 擁有一個包含 API：org.eclipse.swt.accessibility 的易訪問性包。Eclipse 3.0 易訪問性特征是基于 MSAA 1.3 程序設計模型所提供的功能。您可以將 Eclipse 中的 Accessible 對象聯系到每個控件上，并且 org.eclipse.swt.accessibility 接口中的方法集對應 MSAA 1.3 IAccessible 界面中的消息集。
org.eclipse.swt.accessibility 的接口：
| Interface Summary |
| AccessibleControlListener |
Classes that implement this interface provide methods that deal with the events that are generated when an accessibility client sends a message to a control. |
| AccessibleListener |
Classes that implement this interface provide methods that deal with the events that are generated when an accessibility client sends a message to a control. |
| AccessibleTextListener |
Classes that implement this interface provide methods that deal with the events that are generated when an accessibility client sends a message to a control. |
SWT 自身包含的控件中只有寥寥幾個用到了Accessibility，JFace里也不多。看了所有的Accessibility相關代碼，只能總結一部分規律：
- 一般的復雜控件是沒有必要定義Accessibility的。
- 如果是模擬實現一個比較簡單的基本控件，比如Combo，Label，Spinner等，有必要定義Accessibility。
- 所有的自定義控件都要實現AccessibleControlListener接口。
- 所有的包含文本框的控件都要實現AccessibleTextListener接口。
- 設置AccessibleListener的getHelp( )最好是給控件加上Tooltip，因為Wineyes這些屏幕閱讀器閱讀都是根據Tooltip，無視getHelp( )的設置。
- 設置AccessibleListener的getName( )，一般來說，可以設置為這個控件相關聯的Label的Text或者該控件上的某部分文字，自己斟酌考慮設置。
- getKeyboardShortcut( )，考慮控件的快捷操作方式，如果需要的話。
以下是CCombo的Accessibility代碼：
void initAccessible() {
AccessibleAdapter accessibleAdapter = new AccessibleAdapter () {
publicvoid getName (AccessibleEvent e) {
String name = null;
Label label = getAssociatedLabel ();
if (label != null) {
name = stripMnemonic (label.getText());
}
e.result = name;
}
publicvoid getKeyboardShortcut(AccessibleEvent e) {
String shortcut = null;
Label label = getAssociatedLabel ();
if (label != null) {
String text = label.getText ();
if (text != null) {
char mnemonic = _findMnemonic (text);
if (mnemonic != '\0') {
shortcut = "Alt+"+mnemonic;
}
}
}
e.result = shortcut;
}
publicvoid getHelp (AccessibleEvent e) {
e.result = getToolTipText ();
}
};
getAccessible ().addAccessibleListener (accessibleAdapter);
text.getAccessible ().addAccessibleListener (accessibleAdapter);
list.getAccessible ().addAccessibleListener (accessibleAdapter);
arrow.getAccessible ().addAccessibleListener (new AccessibleAdapter() {
publicvoid getName (AccessibleEvent e) {
e.result = isDropped () ? SWT.getMessage ("SWT_Close") : SWT.getMessage ("SWT_Open");
}
publicvoid getKeyboardShortcut (AccessibleEvent e) {
e.result = "Alt+Down Arrow";
}
publicvoid getHelp (AccessibleEvent e) {
e.result = getToolTipText ();
}
});
getAccessible().addAccessibleTextListener (new AccessibleTextAdapter() {
publicvoid getCaretOffset (AccessibleTextEvent e) {
e.offset = text.getCaretPosition ();
}
publicvoid getSelectionRange(AccessibleTextEvent e) {
Point sel = text.getSelection();
e.offset = sel.x;
e.length = sel.y - sel.x;
}
});
getAccessible().addAccessibleControlListener (new AccessibleControlAdapter() {
publicvoid getChildAtPoint (AccessibleControlEvent e) {
Point testPoint = toControl (e.x, e.y);
if (getBounds ().contains (testPoint)) {
e.childID = ACC.CHILDID_SELF;
}
}
publicvoid getLocation (AccessibleControlEvent e) {
Rectangle location = getBounds ();
Point pt = toDisplay (location.x, location.y);
e.x = pt.x;
e.y = pt.y;
e.width = location.width;
e.height = location.height;
}
publicvoid getChildCount (AccessibleControlEvent e) {
e.detail = 0;
}
publicvoid getRole (AccessibleControlEvent e) {
e.detail = ACC.ROLE_COMBOBOX;
}
publicvoid getState (AccessibleControlEvent e) {
e.detail = ACC.STATE_NORMAL;
}
publicvoid getValue (AccessibleControlEvent e) {
e.result = getText ();
}
});
text.getAccessible ().addAccessibleControlListener (new AccessibleControlAdapter () {
publicvoid getRole (AccessibleControlEvent e) {
e.detail = text.getEditable () ? ACC.ROLE_TEXT : ACC.ROLE_LABEL;
}
});
arrow.getAccessible ().addAccessibleControlListener (new AccessibleControlAdapter() {
publicvoid getDefaultAction (AccessibleControlEvent e) {
e.result = isDropped () ? SWT.getMessage ("SWT_Close") : SWT.getMessage ("SWT_Open");
}
});
}
在SWT控件中，包含Accessibility功能的控件有：CCombo，CLabel，CTableFolder，StyledText。