| // Copyright (c) 2012 The Chromium Authors. All rights reserved. |
| // Use of this source code is governed by a BSD-style license that can be |
| // found in the LICENSE file. |
| |
| #include "content/browser/accessibility/accessibility_tree_formatter_utils_win.h" |
| |
| #include <oleacc.h> |
| |
| #include <map> |
| #include <string> |
| |
| #include "base/memory/singleton.h" |
| #include "base/strings/string_util.h" |
| #include "base/strings/utf_string_conversions.h" |
| #include "third_party/iaccessible2/ia2_api_all.h" |
| |
| namespace content { |
| namespace { |
| |
| class AccessibilityEnumMap { |
| public: |
| static AccessibilityEnumMap* GetInstance(); |
| |
| std::map<int32, base::string16> ia_role_string_map; |
| std::map<int32, base::string16> ia2_role_string_map; |
| std::map<int32, base::string16> ia_state_string_map; |
| std::map<int32, base::string16> ia2_state_string_map; |
| std::map<int32, base::string16> event_string_map; |
| |
| private: |
| AccessibilityEnumMap(); |
| virtual ~AccessibilityEnumMap() {} |
| |
| friend struct base::DefaultSingletonTraits<AccessibilityEnumMap>; |
| |
| DISALLOW_COPY_AND_ASSIGN(AccessibilityEnumMap); |
| }; |
| |
| // static |
| AccessibilityEnumMap* AccessibilityEnumMap::GetInstance() { |
| return base::Singleton< |
| AccessibilityEnumMap, |
| base::LeakySingletonTraits<AccessibilityEnumMap>>::get(); |
| } |
| |
| AccessibilityEnumMap::AccessibilityEnumMap() { |
| // Convenience macros for generating readable strings. |
| #define IA_ROLE_MAP(x) ia_role_string_map[x] = L###x; \ |
| ia2_role_string_map[x] = L###x; |
| #define IA2_ROLE_MAP(x) ia2_role_string_map[x] = L###x; |
| #define IA_STATE_MAP(x) ia_state_string_map[STATE_SYSTEM_##x] = L###x; |
| #define IA2_STATE_MAP(x) ia2_state_string_map[x] = L###x; |
| #define EVENT_MAP(x) event_string_map[x] = L###x; |
| |
| // MSAA / IAccessible roles. Each one of these is also a valid |
| // IAccessible2 role, the IA_ROLE_MAP macro adds it to both. |
| IA_ROLE_MAP(ROLE_SYSTEM_ALERT) |
| IA_ROLE_MAP(ROLE_SYSTEM_ANIMATION) |
| IA_ROLE_MAP(ROLE_SYSTEM_APPLICATION) |
| IA_ROLE_MAP(ROLE_SYSTEM_BORDER) |
| IA_ROLE_MAP(ROLE_SYSTEM_BUTTONDROPDOWN) |
| IA_ROLE_MAP(ROLE_SYSTEM_BUTTONDROPDOWNGRID) |
| IA_ROLE_MAP(ROLE_SYSTEM_BUTTONMENU) |
| IA_ROLE_MAP(ROLE_SYSTEM_CARET) |
| IA_ROLE_MAP(ROLE_SYSTEM_CELL) |
| IA_ROLE_MAP(ROLE_SYSTEM_CHARACTER) |
| IA_ROLE_MAP(ROLE_SYSTEM_CHART) |
| IA_ROLE_MAP(ROLE_SYSTEM_CHECKBUTTON) |
| IA_ROLE_MAP(ROLE_SYSTEM_CLIENT) |
| IA_ROLE_MAP(ROLE_SYSTEM_CLOCK) |
| IA_ROLE_MAP(ROLE_SYSTEM_COLUMN) |
| IA_ROLE_MAP(ROLE_SYSTEM_COLUMNHEADER) |
| IA_ROLE_MAP(ROLE_SYSTEM_COMBOBOX) |
| IA_ROLE_MAP(ROLE_SYSTEM_CURSOR) |
| IA_ROLE_MAP(ROLE_SYSTEM_DIAGRAM) |
| IA_ROLE_MAP(ROLE_SYSTEM_DIAL) |
| IA_ROLE_MAP(ROLE_SYSTEM_DIALOG) |
| IA_ROLE_MAP(ROLE_SYSTEM_DOCUMENT) |
| IA_ROLE_MAP(ROLE_SYSTEM_DROPLIST) |
| IA_ROLE_MAP(ROLE_SYSTEM_EQUATION) |
| IA_ROLE_MAP(ROLE_SYSTEM_GRAPHIC) |
| IA_ROLE_MAP(ROLE_SYSTEM_GRIP) |
| IA_ROLE_MAP(ROLE_SYSTEM_GROUPING) |
| IA_ROLE_MAP(ROLE_SYSTEM_HELPBALLOON) |
| IA_ROLE_MAP(ROLE_SYSTEM_HOTKEYFIELD) |
| IA_ROLE_MAP(ROLE_SYSTEM_INDICATOR) |
| IA_ROLE_MAP(ROLE_SYSTEM_IPADDRESS) |
| IA_ROLE_MAP(ROLE_SYSTEM_LINK) |
| IA_ROLE_MAP(ROLE_SYSTEM_LIST) |
| IA_ROLE_MAP(ROLE_SYSTEM_LISTITEM) |
| IA_ROLE_MAP(ROLE_SYSTEM_MENUBAR) |
| IA_ROLE_MAP(ROLE_SYSTEM_MENUITEM) |
| IA_ROLE_MAP(ROLE_SYSTEM_MENUPOPUP) |
| IA_ROLE_MAP(ROLE_SYSTEM_OUTLINE) |
| IA_ROLE_MAP(ROLE_SYSTEM_OUTLINEBUTTON) |
| IA_ROLE_MAP(ROLE_SYSTEM_OUTLINEITEM) |
| IA_ROLE_MAP(ROLE_SYSTEM_PAGETAB) |
| IA_ROLE_MAP(ROLE_SYSTEM_PAGETABLIST) |
| IA_ROLE_MAP(ROLE_SYSTEM_PANE) |
| IA_ROLE_MAP(ROLE_SYSTEM_PROGRESSBAR) |
| IA_ROLE_MAP(ROLE_SYSTEM_PROPERTYPAGE) |
| IA_ROLE_MAP(ROLE_SYSTEM_PUSHBUTTON) |
| IA_ROLE_MAP(ROLE_SYSTEM_RADIOBUTTON) |
| IA_ROLE_MAP(ROLE_SYSTEM_ROW) |
| IA_ROLE_MAP(ROLE_SYSTEM_ROWHEADER) |
| IA_ROLE_MAP(ROLE_SYSTEM_SCROLLBAR) |
| IA_ROLE_MAP(ROLE_SYSTEM_SEPARATOR) |
| IA_ROLE_MAP(ROLE_SYSTEM_SLIDER) |
| IA_ROLE_MAP(ROLE_SYSTEM_SOUND) |
| IA_ROLE_MAP(ROLE_SYSTEM_SPINBUTTON) |
| IA_ROLE_MAP(ROLE_SYSTEM_SPLITBUTTON) |
| IA_ROLE_MAP(ROLE_SYSTEM_STATICTEXT) |
| IA_ROLE_MAP(ROLE_SYSTEM_STATUSBAR) |
| IA_ROLE_MAP(ROLE_SYSTEM_TABLE) |
| IA_ROLE_MAP(ROLE_SYSTEM_TEXT) |
| IA_ROLE_MAP(ROLE_SYSTEM_TITLEBAR) |
| IA_ROLE_MAP(ROLE_SYSTEM_TOOLBAR) |
| IA_ROLE_MAP(ROLE_SYSTEM_TOOLTIP) |
| IA_ROLE_MAP(ROLE_SYSTEM_WHITESPACE) |
| IA_ROLE_MAP(ROLE_SYSTEM_WINDOW) |
| |
| // IAccessible2 roles. |
| IA2_ROLE_MAP(IA2_ROLE_CANVAS) |
| IA2_ROLE_MAP(IA2_ROLE_CAPTION) |
| IA2_ROLE_MAP(IA2_ROLE_CHECK_MENU_ITEM) |
| IA2_ROLE_MAP(IA2_ROLE_COLOR_CHOOSER) |
| IA2_ROLE_MAP(IA2_ROLE_DATE_EDITOR) |
| IA2_ROLE_MAP(IA2_ROLE_DESKTOP_ICON) |
| IA2_ROLE_MAP(IA2_ROLE_DESKTOP_PANE) |
| IA2_ROLE_MAP(IA2_ROLE_DIRECTORY_PANE) |
| IA2_ROLE_MAP(IA2_ROLE_EDITBAR) |
| IA2_ROLE_MAP(IA2_ROLE_EMBEDDED_OBJECT) |
| IA2_ROLE_MAP(IA2_ROLE_ENDNOTE) |
| IA2_ROLE_MAP(IA2_ROLE_FILE_CHOOSER) |
| IA2_ROLE_MAP(IA2_ROLE_FONT_CHOOSER) |
| IA2_ROLE_MAP(IA2_ROLE_FOOTER) |
| IA2_ROLE_MAP(IA2_ROLE_FOOTNOTE) |
| IA2_ROLE_MAP(IA2_ROLE_FORM) |
| IA2_ROLE_MAP(IA2_ROLE_FRAME) |
| IA2_ROLE_MAP(IA2_ROLE_GLASS_PANE) |
| IA2_ROLE_MAP(IA2_ROLE_HEADER) |
| IA2_ROLE_MAP(IA2_ROLE_HEADING) |
| IA2_ROLE_MAP(IA2_ROLE_ICON) |
| IA2_ROLE_MAP(IA2_ROLE_IMAGE_MAP) |
| IA2_ROLE_MAP(IA2_ROLE_INPUT_METHOD_WINDOW) |
| IA2_ROLE_MAP(IA2_ROLE_INTERNAL_FRAME) |
| IA2_ROLE_MAP(IA2_ROLE_LABEL) |
| IA2_ROLE_MAP(IA2_ROLE_LAYERED_PANE) |
| IA2_ROLE_MAP(IA2_ROLE_NOTE) |
| IA2_ROLE_MAP(IA2_ROLE_OPTION_PANE) |
| IA2_ROLE_MAP(IA2_ROLE_PAGE) |
| IA2_ROLE_MAP(IA2_ROLE_PARAGRAPH) |
| IA2_ROLE_MAP(IA2_ROLE_RADIO_MENU_ITEM) |
| IA2_ROLE_MAP(IA2_ROLE_REDUNDANT_OBJECT) |
| IA2_ROLE_MAP(IA2_ROLE_ROOT_PANE) |
| IA2_ROLE_MAP(IA2_ROLE_RULER) |
| IA2_ROLE_MAP(IA2_ROLE_SCROLL_PANE) |
| IA2_ROLE_MAP(IA2_ROLE_SECTION) |
| IA2_ROLE_MAP(IA2_ROLE_SHAPE) |
| IA2_ROLE_MAP(IA2_ROLE_SPLIT_PANE) |
| IA2_ROLE_MAP(IA2_ROLE_TEAR_OFF_MENU) |
| IA2_ROLE_MAP(IA2_ROLE_TERMINAL) |
| IA2_ROLE_MAP(IA2_ROLE_TEXT_FRAME) |
| IA2_ROLE_MAP(IA2_ROLE_TOGGLE_BUTTON) |
| IA2_ROLE_MAP(IA2_ROLE_UNKNOWN) |
| IA2_ROLE_MAP(IA2_ROLE_VIEW_PORT) |
| |
| // MSAA / IAccessible states. Unlike roles, these are not also IA2 states. |
| IA_STATE_MAP(ALERT_HIGH) |
| IA_STATE_MAP(ALERT_LOW) |
| IA_STATE_MAP(ALERT_MEDIUM) |
| IA_STATE_MAP(ANIMATED) |
| IA_STATE_MAP(BUSY) |
| IA_STATE_MAP(CHECKED) |
| IA_STATE_MAP(COLLAPSED) |
| IA_STATE_MAP(DEFAULT) |
| IA_STATE_MAP(EXPANDED) |
| IA_STATE_MAP(EXTSELECTABLE) |
| IA_STATE_MAP(FLOATING) |
| IA_STATE_MAP(FOCUSABLE) |
| IA_STATE_MAP(FOCUSED) |
| IA_STATE_MAP(HASPOPUP) |
| IA_STATE_MAP(HOTTRACKED) |
| IA_STATE_MAP(INVISIBLE) |
| IA_STATE_MAP(LINKED) |
| IA_STATE_MAP(MARQUEED) |
| IA_STATE_MAP(MIXED) |
| IA_STATE_MAP(MOVEABLE) |
| IA_STATE_MAP(MULTISELECTABLE) |
| IA_STATE_MAP(OFFSCREEN) |
| IA_STATE_MAP(PRESSED) |
| IA_STATE_MAP(PROTECTED) |
| IA_STATE_MAP(READONLY) |
| IA_STATE_MAP(SELECTABLE) |
| IA_STATE_MAP(SELECTED) |
| IA_STATE_MAP(SELFVOICING) |
| IA_STATE_MAP(SIZEABLE) |
| IA_STATE_MAP(TRAVERSED) |
| IA_STATE_MAP(UNAVAILABLE) |
| |
| // IAccessible2 states. |
| IA2_STATE_MAP(IA2_STATE_ACTIVE) |
| IA2_STATE_MAP(IA2_STATE_ARMED) |
| IA2_STATE_MAP(IA2_STATE_CHECKABLE) |
| IA2_STATE_MAP(IA2_STATE_DEFUNCT) |
| IA2_STATE_MAP(IA2_STATE_EDITABLE) |
| IA2_STATE_MAP(IA2_STATE_HORIZONTAL) |
| IA2_STATE_MAP(IA2_STATE_ICONIFIED) |
| IA2_STATE_MAP(IA2_STATE_INVALID_ENTRY) |
| IA2_STATE_MAP(IA2_STATE_MANAGES_DESCENDANTS) |
| IA2_STATE_MAP(IA2_STATE_MODAL) |
| IA2_STATE_MAP(IA2_STATE_MULTI_LINE) |
| IA2_STATE_MAP(IA2_STATE_REQUIRED) |
| IA2_STATE_MAP(IA2_STATE_SELECTABLE_TEXT) |
| IA2_STATE_MAP(IA2_STATE_SINGLE_LINE) |
| IA2_STATE_MAP(IA2_STATE_STALE) |
| IA2_STATE_MAP(IA2_STATE_SUPPORTS_AUTOCOMPLETION) |
| IA2_STATE_MAP(IA2_STATE_TRANSIENT) |
| IA2_STATE_MAP(IA2_STATE_VERTICAL) |
| |
| // Untested states include those that would be repeated on nearly every node, |
| // or would vary based on window size. |
| // IA2_STATE_MAP(IA2_STATE_OPAQUE) // Untested. |
| |
| EVENT_MAP(EVENT_OBJECT_CREATE) |
| EVENT_MAP(EVENT_OBJECT_DESTROY) |
| EVENT_MAP(EVENT_OBJECT_SHOW) |
| EVENT_MAP(EVENT_OBJECT_HIDE) |
| EVENT_MAP(EVENT_OBJECT_REORDER) |
| EVENT_MAP(EVENT_OBJECT_FOCUS) |
| EVENT_MAP(EVENT_OBJECT_SELECTION) |
| EVENT_MAP(EVENT_OBJECT_SELECTIONADD) |
| EVENT_MAP(EVENT_OBJECT_SELECTIONREMOVE) |
| EVENT_MAP(EVENT_OBJECT_SELECTIONWITHIN) |
| EVENT_MAP(EVENT_OBJECT_STATECHANGE) |
| EVENT_MAP(EVENT_OBJECT_LOCATIONCHANGE) |
| EVENT_MAP(EVENT_OBJECT_NAMECHANGE) |
| EVENT_MAP(EVENT_OBJECT_DESCRIPTIONCHANGE) |
| EVENT_MAP(EVENT_OBJECT_VALUECHANGE) |
| EVENT_MAP(EVENT_OBJECT_PARENTCHANGE) |
| EVENT_MAP(EVENT_OBJECT_HELPCHANGE) |
| EVENT_MAP(EVENT_OBJECT_DEFACTIONCHANGE) |
| EVENT_MAP(EVENT_OBJECT_ACCELERATORCHANGE) |
| EVENT_MAP(EVENT_OBJECT_INVOKED) |
| EVENT_MAP(EVENT_OBJECT_TEXTSELECTIONCHANGED) |
| EVENT_MAP(EVENT_OBJECT_CONTENTSCROLLED) |
| EVENT_MAP(EVENT_OBJECT_LIVEREGIONCHANGED) |
| EVENT_MAP(EVENT_OBJECT_HOSTEDOBJECTSINVALIDATED) |
| EVENT_MAP(EVENT_OBJECT_DRAGSTART) |
| EVENT_MAP(EVENT_OBJECT_DRAGCANCEL) |
| EVENT_MAP(EVENT_OBJECT_DRAGCOMPLETE) |
| EVENT_MAP(EVENT_OBJECT_DRAGENTER) |
| EVENT_MAP(EVENT_OBJECT_DRAGLEAVE) |
| EVENT_MAP(EVENT_OBJECT_DRAGDROPPED) |
| EVENT_MAP(EVENT_SYSTEM_ALERT) |
| EVENT_MAP(EVENT_SYSTEM_SCROLLINGSTART) |
| EVENT_MAP(EVENT_SYSTEM_SCROLLINGEND) |
| EVENT_MAP(IA2_EVENT_ACTION_CHANGED) |
| EVENT_MAP(IA2_EVENT_ACTIVE_DECENDENT_CHANGED) |
| EVENT_MAP(IA2_EVENT_ACTIVE_DESCENDANT_CHANGED) |
| EVENT_MAP(IA2_EVENT_DOCUMENT_ATTRIBUTE_CHANGED) |
| EVENT_MAP(IA2_EVENT_DOCUMENT_CONTENT_CHANGED) |
| EVENT_MAP(IA2_EVENT_DOCUMENT_LOAD_COMPLETE) |
| EVENT_MAP(IA2_EVENT_DOCUMENT_LOAD_STOPPED) |
| EVENT_MAP(IA2_EVENT_DOCUMENT_RELOAD) |
| EVENT_MAP(IA2_EVENT_HYPERLINK_END_INDEX_CHANGED) |
| EVENT_MAP(IA2_EVENT_HYPERLINK_NUMBER_OF_ANCHORS_CHANGED) |
| EVENT_MAP(IA2_EVENT_HYPERLINK_SELECTED_LINK_CHANGED) |
| EVENT_MAP(IA2_EVENT_HYPERTEXT_LINK_ACTIVATED) |
| EVENT_MAP(IA2_EVENT_HYPERTEXT_LINK_SELECTED) |
| EVENT_MAP(IA2_EVENT_HYPERLINK_START_INDEX_CHANGED) |
| EVENT_MAP(IA2_EVENT_HYPERTEXT_CHANGED) |
| EVENT_MAP(IA2_EVENT_HYPERTEXT_NLINKS_CHANGED) |
| EVENT_MAP(IA2_EVENT_OBJECT_ATTRIBUTE_CHANGED) |
| EVENT_MAP(IA2_EVENT_PAGE_CHANGED) |
| EVENT_MAP(IA2_EVENT_SECTION_CHANGED) |
| EVENT_MAP(IA2_EVENT_TABLE_CAPTION_CHANGED) |
| EVENT_MAP(IA2_EVENT_TABLE_COLUMN_DESCRIPTION_CHANGED) |
| EVENT_MAP(IA2_EVENT_TABLE_COLUMN_HEADER_CHANGED) |
| EVENT_MAP(IA2_EVENT_TABLE_MODEL_CHANGED) |
| EVENT_MAP(IA2_EVENT_TABLE_ROW_DESCRIPTION_CHANGED) |
| EVENT_MAP(IA2_EVENT_TABLE_ROW_HEADER_CHANGED) |
| EVENT_MAP(IA2_EVENT_TABLE_SUMMARY_CHANGED) |
| EVENT_MAP(IA2_EVENT_TEXT_ATTRIBUTE_CHANGED) |
| EVENT_MAP(IA2_EVENT_TEXT_CARET_MOVED) |
| EVENT_MAP(IA2_EVENT_TEXT_CHANGED) |
| EVENT_MAP(IA2_EVENT_TEXT_COLUMN_CHANGED) |
| EVENT_MAP(IA2_EVENT_TEXT_INSERTED) |
| EVENT_MAP(IA2_EVENT_TEXT_REMOVED) |
| EVENT_MAP(IA2_EVENT_TEXT_UPDATED) |
| EVENT_MAP(IA2_EVENT_TEXT_SELECTION_CHANGED) |
| EVENT_MAP(IA2_EVENT_VISIBLE_DATA_CHANGED) |
| } |
| |
| } // namespace. |
| |
| base::string16 IAccessibleRoleToString(int32 ia_role) { |
| return AccessibilityEnumMap::GetInstance()->ia_role_string_map[ia_role]; |
| } |
| |
| base::string16 IAccessible2RoleToString(int32 ia_role) { |
| return AccessibilityEnumMap::GetInstance()->ia2_role_string_map[ia_role]; |
| } |
| |
| void IAccessibleStateToStringVector(int32 ia_state, |
| std::vector<base::string16>* result) { |
| const std::map<int32, base::string16>& state_string_map = |
| AccessibilityEnumMap::GetInstance()->ia_state_string_map; |
| std::map<int32, base::string16>::const_iterator it; |
| for (it = state_string_map.begin(); it != state_string_map.end(); ++it) { |
| if (it->first & ia_state) |
| result->push_back(it->second); |
| } |
| } |
| |
| base::string16 IAccessibleStateToString(int32 ia_state) { |
| std::vector<base::string16> strings; |
| IAccessibleStateToStringVector(ia_state, &strings); |
| return base::JoinString(strings, base::ASCIIToUTF16(",")); |
| } |
| |
| void IAccessible2StateToStringVector(int32 ia2_state, |
| std::vector<base::string16>* result) { |
| const std::map<int32, base::string16>& state_string_map = |
| AccessibilityEnumMap::GetInstance()->ia2_state_string_map; |
| std::map<int32, base::string16>::const_iterator it; |
| for (it = state_string_map.begin(); it != state_string_map.end(); ++it) { |
| if (it->first & ia2_state) |
| result->push_back(it->second); |
| } |
| } |
| |
| base::string16 IAccessible2StateToString(int32 ia2_state) { |
| std::vector<base::string16> strings; |
| IAccessible2StateToStringVector(ia2_state, &strings); |
| return base::JoinString(strings, base::ASCIIToUTF16(",")); |
| } |
| |
| base::string16 AccessibilityEventToString(int32 event_id) { |
| return AccessibilityEnumMap::GetInstance()->event_string_map[event_id]; |
| } |
| |
| } // namespace content |
