| // Copyright 2015 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. |
| |
| #ifndef UI_ACCESSIBILITY_PLATFORM_AX_PLATFORM_NODE_WIN_H_ |
| #define UI_ACCESSIBILITY_PLATFORM_AX_PLATFORM_NODE_WIN_H_ |
| |
| #include <atlbase.h> |
| #include <atlcom.h> |
| #include <objbase.h> |
| #include <oleacc.h> |
| #include <oleauto.h> |
| #include <uiautomation.h> |
| #include <wrl/client.h> |
| |
| #include <vector> |
| |
| #include "base/compiler_specific.h" |
| #include "base/metrics/histogram_macros.h" |
| #include "base/observer_list.h" |
| #include "third_party/iaccessible2/ia2_api_all.h" |
| #include "ui/accessibility/ax_export.h" |
| #include "ui/accessibility/ax_text_utils.h" |
| #include "ui/accessibility/platform/ax_platform_node_base.h" |
| |
| // IMPORTANT! |
| // These values are written to logs. Do not renumber or delete |
| // existing items; add new entries to the end of the list. |
| enum { |
| UMA_API_ACC_DO_DEFAULT_ACTION = 0, |
| UMA_API_ACC_HIT_TEST = 1, |
| UMA_API_ACC_LOCATION = 2, |
| UMA_API_ACC_NAVIGATE = 3, |
| UMA_API_ACC_SELECT = 4, |
| UMA_API_ADD_SELECTION = 5, |
| UMA_API_CONVERT_RETURNED_ELEMENT = 6, |
| UMA_API_DO_ACTION = 7, |
| UMA_API_GET_ACCESSIBLE_AT = 8, |
| UMA_API_GET_ACC_CHILD = 9, |
| UMA_API_GET_ACC_CHILD_COUNT = 10, |
| UMA_API_GET_ACC_DEFAULT_ACTION = 11, |
| UMA_API_GET_ACC_DESCRIPTION = 12, |
| UMA_API_GET_ACC_FOCUS = 13, |
| UMA_API_GET_ACC_HELP = 14, |
| UMA_API_GET_ACC_HELP_TOPIC = 15, |
| UMA_API_GET_ACC_KEYBOARD_SHORTCUT = 16, |
| UMA_API_GET_ACC_NAME = 17, |
| UMA_API_GET_ACC_PARENT = 18, |
| UMA_API_GET_ACC_ROLE = 19, |
| UMA_API_GET_ACC_SELECTION = 20, |
| UMA_API_GET_ACC_STATE = 21, |
| UMA_API_GET_ACC_VALUE = 22, |
| UMA_API_GET_ANCHOR = 23, |
| UMA_API_GET_ANCHOR_TARGET = 24, |
| UMA_API_GET_APP_NAME = 25, |
| UMA_API_GET_APP_VERSION = 26, |
| UMA_API_GET_ATTRIBUTES_FOR_NAMES = 27, |
| UMA_API_GET_CAPTION = 28, |
| UMA_API_GET_CARET_OFFSET = 29, |
| UMA_API_GET_CELL_AT = 30, |
| UMA_API_GET_CHARACTER_EXTENTS = 31, |
| UMA_API_GET_CHILD_AT = 32, |
| UMA_API_GET_CHILD_INDEX = 33, |
| UMA_API_GET_CLIPPED_SUBSTRING_BOUNDS = 34, |
| UMA_API_GET_COLUMN_DESCRIPTION = 35, |
| UMA_API_GET_COLUMN_EXTENT = 36, |
| UMA_API_GET_COLUMN_EXTENT_AT = 37, |
| UMA_API_GET_COLUMN_HEADER = 38, |
| UMA_API_GET_COLUMN_HEADER_CELLS = 39, |
| UMA_API_GET_COLUMN_INDEX = 40, |
| UMA_API_GET_COMPUTED_STYLE = 41, |
| UMA_API_GET_COMPUTED_STYLE_FOR_PROPERTIES = 42, |
| UMA_API_GET_CURRENT_VALUE = 43, |
| UMA_API_GET_DESCRIPTION = 44, |
| UMA_API_GET_DOC_TYPE = 45, |
| UMA_API_GET_DOM_TEXT = 46, |
| UMA_API_GET_END_INDEX = 47, |
| UMA_API_GET_EXTENDED_ROLE = 48, |
| UMA_API_GET_EXTENDED_STATES = 49, |
| UMA_API_GET_FIRST_CHILD = 50, |
| UMA_API_GET_FONT_FAMILY = 51, |
| UMA_API_GET_GROUP_POSITION = 52, |
| UMA_API_GET_HOST_RAW_ELEMENT_PROVIDER = 53, |
| UMA_API_GET_HYPERLINK = 54, |
| UMA_API_GET_HYPERLINK_INDEX = 55, |
| UMA_API_GET_IACCESSIBLE_PAIR = 56, |
| UMA_API_GET_IMAGE_POSITION = 57, |
| UMA_API_GET_IMAGE_SIZE = 58, |
| UMA_API_GET_INDEX_IN_PARENT = 59, |
| UMA_API_GET_INNER_HTML = 60, |
| UMA_API_GET_IS_COLUMN_SELECTED = 61, |
| UMA_API_GET_IS_ROW_SELECTED = 62, |
| UMA_API_GET_IS_SELECTED = 63, |
| UMA_API_GET_KEY_BINDING = 64, |
| UMA_API_GET_LANGUAGE = 65, |
| UMA_API_GET_LAST_CHILD = 66, |
| UMA_API_GET_LOCALE = 67, |
| UMA_API_GET_LOCALIZED_EXTENDED_ROLE = 68, |
| UMA_API_GET_LOCALIZED_EXTENDED_STATES = 69, |
| UMA_API_GET_LOCALIZED_NAME = 70, |
| UMA_API_GET_LOCAL_INTERFACE = 71, |
| UMA_API_GET_MAXIMUM_VALUE = 72, |
| UMA_API_GET_MIME_TYPE = 73, |
| UMA_API_GET_MINIMUM_VALUE = 74, |
| UMA_API_GET_NAME = 75, |
| UMA_API_GET_NAMESPACE_URI_FOR_ID = 76, |
| UMA_API_GET_NEW_TEXT = 77, |
| UMA_API_GET_NEXT_SIBLING = 78, |
| UMA_API_GET_NODE_INFO = 79, |
| UMA_API_GET_N_CHARACTERS = 80, |
| UMA_API_GET_N_COLUMNS = 81, |
| UMA_API_GET_N_EXTENDED_STATES = 82, |
| UMA_API_GET_N_HYPERLINKS = 83, |
| UMA_API_GET_N_RELATIONS = 84, |
| UMA_API_GET_N_ROWS = 85, |
| UMA_API_GET_N_SELECTED_CELLS = 86, |
| UMA_API_GET_N_SELECTED_CHILDREN = 87, |
| UMA_API_GET_N_SELECTED_COLUMNS = 88, |
| UMA_API_GET_N_SELECTED_ROWS = 89, |
| UMA_API_GET_N_SELECTIONS = 90, |
| UMA_API_GET_OBJECT_FOR_CHILD = 91, |
| UMA_API_GET_OFFSET_AT_POINT = 92, |
| UMA_API_GET_OLD_TEXT = 93, |
| UMA_API_GET_PARENT_NODE = 94, |
| UMA_API_GET_PATTERN_PROVIDER = 95, |
| UMA_API_GET_PREVIOUS_SIBLING = 96, |
| UMA_API_GET_PROPERTY_VALUE = 97, |
| UMA_API_GET_PROVIDER_OPTIONS = 98, |
| UMA_API_GET_RELATION = 99, |
| UMA_API_GET_RELATIONS = 100, |
| UMA_API_GET_ROW_COLUMN_EXTENTS = 101, |
| UMA_API_GET_ROW_COLUMN_EXTENTS_AT_INDEX = 102, |
| UMA_API_GET_ROW_DESCRIPTION = 103, |
| UMA_API_GET_ROW_EXTENT = 104, |
| UMA_API_GET_ROW_EXTENT_AT = 105, |
| UMA_API_GET_ROW_HEADER = 106, |
| UMA_API_GET_ROW_HEADER_CELLS = 107, |
| UMA_API_GET_ROW_INDEX = 108, |
| UMA_API_GET_RUNTIME_ID = 109, |
| UMA_API_GET_SELECTED_CELLS = 110, |
| UMA_API_GET_SELECTED_CHILDREN = 111, |
| UMA_API_GET_SELECTED_COLUMNS = 112, |
| UMA_API_GET_SELECTED_ROWS = 113, |
| UMA_API_GET_SELECTION = 114, |
| UMA_API_GET_START_INDEX = 115, |
| UMA_API_GET_STATES = 116, |
| UMA_API_GET_SUMMARY = 117, |
| UMA_API_GET_TABLE = 118, |
| UMA_API_GET_TEXT = 119, |
| UMA_API_GET_TEXT_AFTER_OFFSET = 120, |
| UMA_API_GET_TEXT_AT_OFFSET = 121, |
| UMA_API_GET_TEXT_BEFORE_OFFSET = 122, |
| UMA_API_GET_TITLE = 123, |
| UMA_API_GET_TOOLKIT_NAME = 124, |
| UMA_API_GET_TOOLKIT_VERSION = 125, |
| UMA_API_GET_UNCLIPPED_SUBSTRING_BOUNDS = 126, |
| UMA_API_GET_UNIQUE_ID = 127, |
| UMA_API_GET_URL = 128, |
| UMA_API_GET_VALID = 129, |
| UMA_API_GET_WINDOW_HANDLE = 130, |
| UMA_API_IA2_GET_ATTRIBUTES = 131, |
| UMA_API_IA2_SCROLL_TO = 132, |
| UMA_API_IAACTION_GET_DESCRIPTION = 133, |
| UMA_API_IATEXT_GET_ATTRIBUTES = 134, |
| UMA_API_ISIMPLEDOMNODE_GET_ATTRIBUTES = 135, |
| UMA_API_ISIMPLEDOMNODE_SCROLL_TO = 136, |
| UMA_API_N_ACTIONS = 137, |
| UMA_API_PUT_ALTERNATE_VIEW_MEDIA_TYPES = 138, |
| UMA_API_QUERY_SERVICE = 139, |
| UMA_API_REMOVE_SELECTION = 140, |
| UMA_API_ROLE = 141, |
| UMA_API_SCROLL_SUBSTRING_TO = 142, |
| UMA_API_SCROLL_SUBSTRING_TO_POINT = 143, |
| UMA_API_SCROLL_TO_POINT = 144, |
| UMA_API_SCROLL_TO_SUBSTRING = 145, |
| UMA_API_SELECT_COLUMN = 146, |
| UMA_API_SELECT_ROW = 147, |
| UMA_API_SET_CARET_OFFSET = 148, |
| UMA_API_SET_CURRENT_VALUE = 149, |
| UMA_API_SET_SELECTION = 150, |
| UMA_API_TABLE2_GET_SELECTED_COLUMNS = 151, |
| UMA_API_TABLE2_GET_SELECTED_ROWS = 152, |
| UMA_API_TABLECELL_GET_COLUMN_INDEX = 153, |
| UMA_API_TABLECELL_GET_IS_SELECTED = 154, |
| UMA_API_TABLECELL_GET_ROW_INDEX = 155, |
| UMA_API_UNSELECT_COLUMN = 156, |
| UMA_API_UNSELECT_ROW = 157, |
| |
| // This must always be the last enum. It's okay for its value to |
| // increase, but none of the other enum values may change. |
| UMA_API_MAX |
| }; |
| |
| #define WIN_ACCESSIBILITY_API_HISTOGRAM(enum_value) \ |
| UMA_HISTOGRAM_ENUMERATION("Accessibility.WinAPIs", enum_value, UMA_API_MAX) |
| |
| namespace ui { |
| class AXPlatformNodeWin; |
| class AXPlatformRelationWin; |
| |
| // A simple interface for a class that wants to be notified when IAccessible2 |
| // is used by a client, a strong indication that full accessibility support |
| // should be enabled. |
| class AX_EXPORT IAccessible2UsageObserver { |
| public: |
| IAccessible2UsageObserver(); |
| virtual ~IAccessible2UsageObserver(); |
| virtual void OnIAccessible2Used() = 0; |
| }; |
| |
| struct AX_EXPORT AXHypertext { |
| AXHypertext(); |
| AXHypertext(const AXHypertext& other); |
| ~AXHypertext(); |
| |
| // Maps an embedded character offset in |hypertext| to an index in |
| // |hyperlinks|. |
| std::map<int32_t, int32_t> hyperlink_offset_to_index; |
| |
| // The unique id of a AXPlatformNodes for each hyperlink. |
| // TODO(nektar): Replace object IDs with child indices if we decide that |
| // we are not implementing IA2 hyperlinks for anything other than IA2 |
| // Hypertext. |
| std::vector<int32_t> hyperlinks; |
| |
| base::string16 hypertext; |
| }; |
| |
| // Get an observer list that allows modules across the codebase to |
| // listen to when usage of IAccessible2 is detected. |
| extern AX_EXPORT base::ObserverList<IAccessible2UsageObserver>& |
| GetIAccessible2UsageObserverList(); |
| |
| class AX_EXPORT __declspec(uuid("26f5641a-246d-457b-a96d-07f3fae6acf2")) |
| AXPlatformNodeWin : public CComObjectRootEx<CComMultiThreadModel>, |
| public IDispatchImpl<IAccessible2_2, |
| &IID_IAccessible2, |
| &LIBID_IAccessible2Lib>, |
| public IAccessibleEx, |
| public IAccessibleText, |
| public IAccessibleTable, |
| public IAccessibleTable2, |
| public IAccessibleTableCell, |
| public IExpandCollapseProvider, |
| public IGridItemProvider, |
| public IGridProvider, |
| public IRangeValueProvider, |
| public IRawElementProviderSimple, |
| public IScrollItemProvider, |
| public ISelectionItemProvider, |
| public ISelectionProvider, |
| public IServiceProvider, |
| public ITableItemProvider, |
| public ITableProvider, |
| public IToggleProvider, |
| public IValueProvider, |
| public AXPlatformNodeBase { |
| public: |
| BEGIN_COM_MAP(AXPlatformNodeWin) |
| COM_INTERFACE_ENTRY2(IDispatch, IAccessible2_2) |
| COM_INTERFACE_ENTRY(AXPlatformNodeWin) |
| COM_INTERFACE_ENTRY(IAccessible) |
| COM_INTERFACE_ENTRY(IAccessible2) |
| COM_INTERFACE_ENTRY(IAccessible2_2) |
| COM_INTERFACE_ENTRY(IAccessibleEx) |
| COM_INTERFACE_ENTRY(IAccessibleText) |
| COM_INTERFACE_ENTRY(IAccessibleTable) |
| COM_INTERFACE_ENTRY(IAccessibleTable2) |
| COM_INTERFACE_ENTRY(IAccessibleTableCell) |
| COM_INTERFACE_ENTRY(IExpandCollapseProvider) |
| COM_INTERFACE_ENTRY(IGridItemProvider) |
| COM_INTERFACE_ENTRY(IGridProvider) |
| COM_INTERFACE_ENTRY(IRangeValueProvider) |
| COM_INTERFACE_ENTRY(IRawElementProviderSimple) |
| COM_INTERFACE_ENTRY(IScrollItemProvider) |
| COM_INTERFACE_ENTRY(ISelectionItemProvider) |
| COM_INTERFACE_ENTRY(ISelectionProvider) |
| COM_INTERFACE_ENTRY(ITableItemProvider) |
| COM_INTERFACE_ENTRY(ITableProvider) |
| COM_INTERFACE_ENTRY(IToggleProvider) |
| COM_INTERFACE_ENTRY(IValueProvider) |
| COM_INTERFACE_ENTRY(IServiceProvider) |
| END_COM_MAP() |
| |
| ~AXPlatformNodeWin() override; |
| |
| // Return the number of instances of AXPlatformNodeWin, for leak testing. |
| static size_t GetInstanceCountForTesting(); |
| |
| void Init(AXPlatformNodeDelegate* delegate) override; |
| |
| // Represents a non-static text node in IAccessibleHypertext. This character |
| // is embedded in the response to IAccessibleText::get_text, indicating the |
| // position where a non-static text child object appears. |
| static const base::char16 kEmbeddedCharacter; |
| |
| // Clear any AXPlatformRelationWin nodes owned by this node. |
| void ClearOwnRelations(); |
| static AXPlatformNode* GetFromUniqueId(int32_t unique_id); |
| |
| // AXPlatformNode overrides. |
| gfx::NativeViewAccessible GetNativeViewAccessible() override; |
| void NotifyAccessibilityEvent(ax::mojom::Event event_type) override; |
| |
| // AXPlatformNodeBase overrides. |
| void Destroy() override; |
| int GetIndexInParent() override; |
| base::string16 GetText() override; |
| base::string16 GetValue() override; |
| |
| // |
| // IAccessible methods. |
| // |
| |
| // Retrieves the child element or child object at a given point on the screen. |
| STDMETHODIMP accHitTest(LONG x_left, LONG y_top, VARIANT* child) override; |
| |
| // Performs the object's default action. |
| STDMETHODIMP accDoDefaultAction(VARIANT var_id) override; |
| |
| // Retrieves the specified object's current screen location. |
| STDMETHODIMP accLocation(LONG* x_left, |
| LONG* y_top, |
| LONG* width, |
| LONG* height, |
| VARIANT var_id) override; |
| |
| // Traverses to another UI element and retrieves the object. |
| STDMETHODIMP accNavigate(LONG nav_dir, VARIANT start, VARIANT* end) override; |
| |
| // Retrieves an IDispatch interface pointer for the specified child. |
| STDMETHODIMP get_accChild(VARIANT var_child, IDispatch** disp_child) override; |
| |
| // Retrieves the number of accessible children. |
| STDMETHODIMP get_accChildCount(LONG* child_count) override; |
| |
| // Retrieves a string that describes the object's default action. |
| STDMETHODIMP get_accDefaultAction(VARIANT var_id, |
| BSTR* default_action) override; |
| |
| // Retrieves the tooltip description. |
| STDMETHODIMP get_accDescription(VARIANT var_id, BSTR* desc) override; |
| |
| // Retrieves the object that has the keyboard focus. |
| STDMETHODIMP get_accFocus(VARIANT* focus_child) override; |
| |
| // Retrieves the specified object's shortcut. |
| STDMETHODIMP get_accKeyboardShortcut(VARIANT var_id, |
| BSTR* access_key) override; |
| |
| // Retrieves the name of the specified object. |
| STDMETHODIMP get_accName(VARIANT var_id, BSTR* name) override; |
| |
| // Retrieves the IDispatch interface of the object's parent. |
| STDMETHODIMP get_accParent(IDispatch** disp_parent) override; |
| |
| // Retrieves information describing the role of the specified object. |
| STDMETHODIMP get_accRole(VARIANT var_id, VARIANT* role) override; |
| |
| // Retrieves the current state of the specified object. |
| STDMETHODIMP get_accState(VARIANT var_id, VARIANT* state) override; |
| |
| // Gets the help string for the specified object. |
| STDMETHODIMP get_accHelp(VARIANT var_id, BSTR* help) override; |
| |
| // Retrieve or set the string value associated with the specified object. |
| // Setting the value is not typically used by screen readers, but it's |
| // used frequently by automation software. |
| STDMETHODIMP get_accValue(VARIANT var_id, BSTR* value) override; |
| STDMETHODIMP put_accValue(VARIANT var_id, BSTR new_value) override; |
| |
| // IAccessible methods not implemented. |
| STDMETHODIMP get_accSelection(VARIANT* selected) override; |
| STDMETHODIMP accSelect(LONG flags_sel, VARIANT var_id) override; |
| STDMETHODIMP get_accHelpTopic(BSTR* help_file, |
| VARIANT var_id, |
| LONG* topic_id) override; |
| STDMETHODIMP put_accName(VARIANT var_id, BSTR put_name) override; |
| |
| // |
| // IAccessible2 methods. |
| // |
| |
| STDMETHODIMP role(LONG* role) override; |
| |
| STDMETHODIMP get_states(AccessibleStates* states) override; |
| |
| STDMETHODIMP get_uniqueID(LONG* unique_id) override; |
| |
| STDMETHODIMP get_windowHandle(HWND* window_handle) override; |
| |
| STDMETHODIMP get_relationTargetsOfType(BSTR type, |
| LONG max_targets, |
| IUnknown*** targets, |
| LONG* n_targets) override; |
| |
| STDMETHODIMP get_attributes(BSTR* attributes) override; |
| |
| STDMETHODIMP get_indexInParent(LONG* index_in_parent) override; |
| |
| STDMETHODIMP get_nRelations(LONG* n_relations) override; |
| |
| STDMETHODIMP get_relation(LONG relation_index, |
| IAccessibleRelation** relation) override; |
| |
| STDMETHODIMP get_relations(LONG max_relations, |
| IAccessibleRelation** relations, |
| LONG* n_relations) override; |
| |
| STDMETHODIMP get_attribute(BSTR name, VARIANT* attribute) override; |
| STDMETHODIMP get_extendedRole(BSTR* extended_role) override; |
| STDMETHODIMP scrollTo(enum IA2ScrollType scroll_type) override; |
| STDMETHODIMP scrollToPoint(enum IA2CoordinateType coordinate_type, |
| LONG x, |
| LONG y) override; |
| STDMETHODIMP get_groupPosition(LONG* group_level, |
| LONG* similar_items_in_group, |
| LONG* position_in_group) override; |
| STDMETHODIMP get_localizedExtendedRole( |
| BSTR* localized_extended_role) override; |
| STDMETHODIMP get_nExtendedStates(LONG* n_extended_states) override; |
| STDMETHODIMP get_extendedStates(LONG max_extended_states, |
| BSTR** extended_states, |
| LONG* n_extended_states) override; |
| STDMETHODIMP get_localizedExtendedStates( |
| LONG max_localized_extended_states, |
| BSTR** localized_extended_states, |
| LONG* n_localized_extended_states) override; |
| STDMETHODIMP get_locale(IA2Locale* locale) override; |
| STDMETHODIMP get_accessibleWithCaret(IUnknown** accessible, |
| LONG* caret_offset) override; |
| |
| // |
| // IAccessibleEx methods. |
| // |
| |
| STDMETHODIMP GetObjectForChild(LONG child_id, |
| IAccessibleEx** result) override; |
| |
| STDMETHODIMP GetIAccessiblePair(IAccessible** accessible, |
| LONG* child_id) override; |
| |
| // |
| // IExpandCollapseProvider methods. |
| // |
| |
| STDMETHODIMP Collapse() override; |
| |
| STDMETHODIMP Expand() override; |
| |
| STDMETHODIMP get_ExpandCollapseState(ExpandCollapseState* result) override; |
| |
| // |
| // IGridItemProvider methods. |
| // |
| |
| STDMETHODIMP get_Column(int* result) override; |
| |
| STDMETHODIMP get_ColumnSpan(int* result) override; |
| |
| STDMETHODIMP get_ContainingGrid(IRawElementProviderSimple** result) override; |
| |
| STDMETHODIMP get_Row(int* result) override; |
| |
| STDMETHODIMP get_RowSpan(int* result) override; |
| |
| // |
| // IGridProvider methods. |
| // |
| |
| STDMETHODIMP GetItem(int row, |
| int column, |
| IRawElementProviderSimple** result) override; |
| |
| STDMETHODIMP get_RowCount(int* result) override; |
| |
| STDMETHODIMP get_ColumnCount(int* result) override; |
| |
| // |
| // IScrollItemProvider methods. |
| // |
| |
| STDMETHODIMP ScrollIntoView() override; |
| |
| // |
| // ISelectionItemProvider methods. |
| // |
| |
| STDMETHODIMP AddToSelection() override; |
| |
| STDMETHODIMP RemoveFromSelection() override; |
| |
| STDMETHODIMP Select() override; |
| |
| STDMETHODIMP get_IsSelected(BOOL* result) override; |
| |
| STDMETHODIMP get_SelectionContainer( |
| IRawElementProviderSimple** result) override; |
| |
| // |
| // ISelectionProvider methods. |
| // |
| |
| STDMETHODIMP GetSelection(SAFEARRAY** result) override; |
| |
| STDMETHODIMP get_CanSelectMultiple(BOOL* result) override; |
| |
| STDMETHODIMP get_IsSelectionRequired(BOOL* result) override; |
| |
| // |
| // ITableItemProvider methods. |
| // |
| |
| STDMETHODIMP GetColumnHeaderItems(SAFEARRAY** result) override; |
| |
| STDMETHODIMP GetRowHeaderItems(SAFEARRAY** result) override; |
| |
| // |
| // ITableProvider methods. |
| // |
| |
| STDMETHODIMP GetColumnHeaders(SAFEARRAY** result) override; |
| |
| STDMETHODIMP GetRowHeaders(SAFEARRAY** result) override; |
| |
| STDMETHODIMP get_RowOrColumnMajor(RowOrColumnMajor* result) override; |
| |
| // |
| // IToggleProvider methods. |
| // |
| |
| STDMETHODIMP Toggle() override; |
| |
| STDMETHODIMP get_ToggleState(ToggleState* result) override; |
| |
| // |
| // IValueProvider methods. |
| // |
| |
| STDMETHODIMP SetValue(LPCWSTR val) override; |
| |
| STDMETHODIMP get_IsReadOnly(BOOL* result) override; |
| |
| STDMETHODIMP get_Value(BSTR* result) override; |
| |
| // |
| // IRangeValueProvider methods. |
| // |
| |
| STDMETHODIMP SetValue(double val) override; |
| |
| STDMETHODIMP get_LargeChange(double* result) override; |
| |
| STDMETHODIMP get_Maximum(double* result) override; |
| |
| STDMETHODIMP get_Minimum(double* result) override; |
| |
| STDMETHODIMP get_SmallChange(double* result) override; |
| |
| STDMETHODIMP get_Value(double* result) override; |
| |
| // IAccessibleEx methods not implemented. |
| STDMETHODIMP GetRuntimeId(SAFEARRAY** runtime_id) override; |
| |
| STDMETHODIMP |
| ConvertReturnedElement(IRawElementProviderSimple* element, |
| IAccessibleEx** acc) override; |
| |
| // |
| // IAccessibleText methods. |
| // |
| |
| STDMETHODIMP get_nCharacters(LONG* n_characters) override; |
| |
| STDMETHODIMP get_caretOffset(LONG* offset) override; |
| |
| STDMETHODIMP get_nSelections(LONG* n_selections) override; |
| |
| STDMETHODIMP get_selection(LONG selection_index, |
| LONG* start_offset, |
| LONG* end_offset) override; |
| |
| STDMETHODIMP get_text(LONG start_offset, |
| LONG end_offset, |
| BSTR* text) override; |
| |
| STDMETHODIMP get_textAtOffset(LONG offset, |
| enum IA2TextBoundaryType boundary_type, |
| LONG* start_offset, |
| LONG* end_offset, |
| BSTR* text) override; |
| |
| STDMETHODIMP get_textBeforeOffset(LONG offset, |
| enum IA2TextBoundaryType boundary_type, |
| LONG* start_offset, |
| LONG* end_offset, |
| BSTR* text) override; |
| |
| STDMETHODIMP get_textAfterOffset(LONG offset, |
| enum IA2TextBoundaryType boundary_type, |
| LONG* start_offset, |
| LONG* end_offset, |
| BSTR* text) override; |
| |
| STDMETHODIMP get_offsetAtPoint(LONG x, |
| LONG y, |
| enum IA2CoordinateType coord_type, |
| LONG* offset) override; |
| |
| // |
| // IAccessibleTable methods. |
| // |
| |
| // get_description - also used by IAccessibleImage |
| |
| STDMETHODIMP get_accessibleAt(LONG row, |
| LONG column, |
| IUnknown** accessible) override; |
| |
| STDMETHODIMP get_caption(IUnknown** accessible) override; |
| |
| STDMETHODIMP get_childIndex(LONG row_index, |
| LONG column_index, |
| LONG* cell_index) override; |
| |
| STDMETHODIMP get_columnDescription(LONG column, BSTR* description) override; |
| |
| STDMETHODIMP |
| get_columnExtentAt(LONG row, LONG column, LONG* n_columns_spanned) override; |
| |
| STDMETHODIMP |
| get_columnHeader(IAccessibleTable** accessible_table, |
| LONG* starting_row_index) override; |
| |
| STDMETHODIMP get_columnIndex(LONG cell_index, LONG* column_index) override; |
| |
| STDMETHODIMP get_nColumns(LONG* column_count) override; |
| |
| STDMETHODIMP get_nRows(LONG* row_count) override; |
| |
| STDMETHODIMP get_nSelectedChildren(LONG* cell_count) override; |
| |
| STDMETHODIMP get_nSelectedColumns(LONG* column_count) override; |
| |
| STDMETHODIMP get_nSelectedRows(LONG* row_count) override; |
| |
| STDMETHODIMP get_rowDescription(LONG row, BSTR* description) override; |
| |
| STDMETHODIMP get_rowExtentAt(LONG row, |
| LONG column, |
| LONG* n_rows_spanned) override; |
| |
| STDMETHODIMP |
| get_rowHeader(IAccessibleTable** accessible_table, |
| LONG* starting_column_index) override; |
| |
| STDMETHODIMP get_rowIndex(LONG cell_index, LONG* row_index) override; |
| |
| STDMETHODIMP get_selectedChildren(LONG max_children, |
| LONG** children, |
| LONG* n_children) override; |
| |
| STDMETHODIMP get_selectedColumns(LONG max_columns, |
| LONG** columns, |
| LONG* n_columns) override; |
| |
| STDMETHODIMP get_selectedRows(LONG max_rows, |
| LONG** rows, |
| LONG* n_rows) override; |
| |
| STDMETHODIMP get_summary(IUnknown** accessible) override; |
| |
| STDMETHODIMP |
| get_isColumnSelected(LONG column, boolean* is_selected) override; |
| |
| STDMETHODIMP get_isRowSelected(LONG row, boolean* is_selected) override; |
| |
| STDMETHODIMP get_isSelected(LONG row, |
| LONG column, |
| boolean* is_selected) override; |
| |
| STDMETHODIMP |
| get_rowColumnExtentsAtIndex(LONG index, |
| LONG* row, |
| LONG* column, |
| LONG* row_extents, |
| LONG* column_extents, |
| boolean* is_selected) override; |
| |
| STDMETHODIMP selectRow(LONG row) override; |
| |
| STDMETHODIMP selectColumn(LONG column) override; |
| |
| STDMETHODIMP unselectRow(LONG row) override; |
| |
| STDMETHODIMP unselectColumn(LONG column) override; |
| |
| STDMETHODIMP |
| get_modelChange(IA2TableModelChange* model_change) override; |
| |
| // |
| // IAccessibleTable2 methods. |
| // |
| // (Most of these are duplicates of IAccessibleTable methods, only the |
| // unique ones are included here.) |
| // |
| |
| STDMETHODIMP get_cellAt(LONG row, LONG column, IUnknown** cell) override; |
| |
| STDMETHODIMP get_nSelectedCells(LONG* cell_count) override; |
| |
| STDMETHODIMP |
| get_selectedCells(IUnknown*** cells, LONG* n_selected_cells) override; |
| |
| STDMETHODIMP get_selectedColumns(LONG** columns, LONG* n_columns) override; |
| |
| STDMETHODIMP get_selectedRows(LONG** rows, LONG* n_rows) override; |
| |
| // |
| // IAccessibleTableCell methods. |
| // |
| |
| STDMETHODIMP |
| get_columnExtent(LONG* n_columns_spanned) override; |
| |
| STDMETHODIMP |
| get_columnHeaderCells(IUnknown*** cell_accessibles, |
| LONG* n_column_header_cells) override; |
| |
| STDMETHODIMP get_columnIndex(LONG* column_index) override; |
| |
| STDMETHODIMP get_rowExtent(LONG* n_rows_spanned) override; |
| |
| STDMETHODIMP |
| get_rowHeaderCells(IUnknown*** cell_accessibles, |
| LONG* n_row_header_cells) override; |
| |
| STDMETHODIMP get_rowIndex(LONG* row_index) override; |
| |
| STDMETHODIMP get_isSelected(boolean* is_selected) override; |
| |
| STDMETHODIMP |
| get_rowColumnExtents(LONG* row, |
| LONG* column, |
| LONG* row_extents, |
| LONG* column_extents, |
| boolean* is_selected) override; |
| |
| STDMETHODIMP get_table(IUnknown** table) override; |
| |
| // |
| // IAccessibleText methods not implemented. |
| // |
| |
| STDMETHODIMP get_newText(IA2TextSegment* new_text) override; |
| STDMETHODIMP get_oldText(IA2TextSegment* old_text) override; |
| STDMETHODIMP addSelection(LONG start_offset, LONG end_offset) override; |
| STDMETHODIMP get_attributes(LONG offset, |
| LONG* start_offset, |
| LONG* end_offset, |
| BSTR* text_attributes) override; |
| STDMETHODIMP get_characterExtents(LONG offset, |
| enum IA2CoordinateType coord_type, |
| LONG* x, |
| LONG* y, |
| LONG* width, |
| LONG* height) override; |
| STDMETHODIMP removeSelection(LONG selection_index) override; |
| STDMETHODIMP setCaretOffset(LONG offset) override; |
| STDMETHODIMP setSelection(LONG selection_index, |
| LONG start_offset, |
| LONG end_offset) override; |
| STDMETHODIMP scrollSubstringTo(LONG start_index, |
| LONG end_index, |
| enum IA2ScrollType scroll_type) override; |
| STDMETHODIMP scrollSubstringToPoint(LONG start_index, |
| LONG end_index, |
| enum IA2CoordinateType coordinate_type, |
| LONG x, |
| LONG y) override; |
| |
| // |
| // IRawElementProviderSimple methods. |
| // |
| |
| STDMETHODIMP GetPatternProvider(PATTERNID pattern_id, |
| IUnknown** result) override; |
| |
| STDMETHODIMP GetPropertyValue(PROPERTYID property_id, |
| VARIANT* result) override; |
| |
| // IRawElementProviderSimple methods not implemented. |
| |
| STDMETHODIMP |
| get_ProviderOptions(enum ProviderOptions* ret) override; |
| |
| STDMETHODIMP |
| get_HostRawElementProvider(IRawElementProviderSimple** provider) override; |
| |
| // |
| // IServiceProvider methods. |
| // |
| |
| STDMETHODIMP QueryService(REFGUID guidService, |
| REFIID riid, |
| void** object) override; |
| |
| protected: |
| AXPlatformNodeWin(); |
| |
| int MSAAState(); |
| |
| int MSAARole(); |
| std::string StringOverrideForMSAARole(); |
| |
| int32_t ComputeIA2State(); |
| |
| int32_t ComputeIA2Role(); |
| |
| std::vector<base::string16> ComputeIA2Attributes(); |
| |
| base::string16 UIAAriaRole(); |
| |
| base::string16 ComputeUIAProperties(); |
| |
| long ComputeUIAControlType(); |
| |
| AXHypertext ComputeHypertext(); |
| |
| // AXPlatformNodeBase overrides. |
| void Dispose() override; |
| |
| // Relationships between this node and other nodes. |
| std::vector<Microsoft::WRL::ComPtr<AXPlatformRelationWin>> relations_; |
| |
| AXHypertext old_hypertext_; |
| AXHypertext hypertext_; |
| |
| // These protected methods are still used by BrowserAccessibilityComWin. At |
| // some point post conversion, we can probably move these to be private |
| // methods. |
| // |
| // |
| // Selection helper functions. |
| // The following functions retrieve the endpoints of the current selection. |
| // First they check for a local selection found on the current control, e.g. |
| // when querying the selection on a textarea. |
| // If not found they retrieve the global selection found on the current frame. |
| int GetSelectionAnchor(); |
| int GetSelectionFocus(); |
| |
| // Retrieves the selection offsets in the way required by the IA2 APIs. |
| // selection_start and selection_end are -1 when there is no selection active |
| // on this object. |
| // The greatest of the two offsets is one past the last character of the |
| // selection.) |
| void GetSelectionOffsets(int* selection_start, int* selection_end); |
| |
| // |
| // Helper methods for IA2 hyperlinks. |
| // |
| // Hyperlink is an IA2 misnomer. It refers to objects embedded within other |
| // objects, such as a numbered list within a contenteditable div. |
| // Also, in IA2, text that includes embedded objects is called hypertext. |
| // Returns true if the current object is an IA2 hyperlink. |
| bool IsHyperlink(); |
| |
| // Returns the hyperlink at the given text position, or nullptr if no |
| // hyperlink can be found. |
| AXPlatformNodeWin* GetHyperlinkFromHypertextOffset(int offset); |
| |
| // Functions for retrieving offsets for hyperlinks and hypertext. |
| // Return -1 in case of failure. |
| int32_t GetHyperlinkIndexFromChild(AXPlatformNodeWin* child); |
| int32_t GetHypertextOffsetFromHyperlinkIndex(int32_t hyperlink_index); |
| int32_t GetHypertextOffsetFromChild(AXPlatformNodeWin* child); |
| int32_t GetHypertextOffsetFromDescendant(AXPlatformNodeWin* descendant); |
| |
| // If the selection endpoint is either equal to or an ancestor of this object, |
| // returns endpoint_offset. |
| // If the selection endpoint is a descendant of this object, returns its |
| // offset. Otherwise, returns either 0 or the length of the hypertext |
| // depending on the direction of the selection. |
| // Returns -1 in case of unexpected failure, e.g. the selection endpoint |
| // cannot be found in the accessibility tree. |
| int GetHypertextOffsetFromEndpoint(AXPlatformNodeWin* endpoint_object, |
| int endpoint_offset); |
| bool IsSameHypertextCharacter(size_t old_char_index, size_t new_char_index); |
| void ComputeHypertextRemovedAndInserted(int* start, |
| int* old_len, |
| int* new_len); |
| |
| // If offset is a member of IA2TextSpecialOffsets this function updates the |
| // value of offset and returns, otherwise offset remains unchanged. |
| void HandleSpecialTextOffset(LONG* offset); |
| |
| // Convert from a IA2TextBoundaryType to a TextBoundaryType. |
| TextBoundaryType IA2TextBoundaryToTextBoundary(IA2TextBoundaryType type); |
| |
| private: |
| int MSAAEvent(ax::mojom::Event event); |
| bool IsWebAreaForPresentationalIframe(); |
| bool ShouldNodeHaveReadonlyStateByDefault(const AXNodeData& data) const; |
| bool ShouldNodeHaveFocusableState(const AXNodeData& data) const; |
| |
| HRESULT GetStringAttributeAsBstr(ax::mojom::StringAttribute attribute, |
| BSTR* value_bstr) const; |
| |
| // Escapes characters in string attributes as required by the IA2 Spec. |
| // It's okay for input to be the same as output. |
| static void SanitizeStringAttributeForIA2(const base::string16& input, |
| base::string16* output); |
| |
| // Sets the selection given a start and end offset in IA2 Hypertext. |
| void SetIA2HypertextSelection(LONG start_offset, LONG end_offset); |
| |
| // If the string attribute |attribute| is present, add its value as an |
| // IAccessible2 attribute with the name |ia2_attr|. |
| void StringAttributeToIA2(std::vector<base::string16>& attributes, |
| ax::mojom::StringAttribute attribute, |
| const char* ia2_attr); |
| |
| // If the bool attribute |attribute| is present, add its value as an |
| // IAccessible2 attribute with the name |ia2_attr|. |
| void BoolAttributeToIA2(std::vector<base::string16>& attributes, |
| ax::mojom::BoolAttribute attribute, |
| const char* ia2_attr); |
| |
| // If the int attribute |attribute| is present, add its value as an |
| // IAccessible2 attribute with the name |ia2_attr|. |
| void IntAttributeToIA2(std::vector<base::string16>& attributes, |
| ax::mojom::IntAttribute attribute, |
| const char* ia2_attr); |
| |
| // Escapes characters in string attributes as required by the UIA Aria |
| // Property Spec. It's okay for input to be the same as output. |
| static void SanitizeStringAttributeForUIAAriaProperty( |
| const base::string16& input, |
| base::string16* output); |
| |
| // If the string attribute |attribute| is present, add its value as a |
| // UIA AriaProperties Property with the name |uia_aria_property|. |
| void StringAttributeToUIAAriaProperty(std::vector<base::string16>& properties, |
| ax::mojom::StringAttribute attribute, |
| const char* uia_aria_property); |
| |
| // If the bool attribute |attribute| is present, add its value as a |
| // UIA AriaProperties Property with the name |uia_aria_property|. |
| void BoolAttributeToUIAAriaProperty(std::vector<base::string16>& properties, |
| ax::mojom::BoolAttribute attribute, |
| const char* uia_aria_property); |
| |
| // If the int attribute |attribute| is present, add its value as a |
| // UIA AriaProperties Property with the name |uia_aria_property|. |
| void IntAttributeToUIAAriaProperty(std::vector<base::string16>& properties, |
| ax::mojom::IntAttribute attribute, |
| const char* uia_aria_property); |
| |
| // If the float attribute |attribute| is present, add its value as a |
| // UIA AriaProperties Property with the name |uia_aria_property|. |
| void FloatAttributeToUIAAriaProperty(std::vector<base::string16>& properties, |
| ax::mojom::FloatAttribute attribute, |
| const char* uia_aria_property); |
| |
| // If the state |state| exists, set the |
| // UIA AriaProperties Property with the name |uia_aria_property| to "true". |
| // Otherwise set the AriaProperties Property to "false". |
| void StateToUIAAriaProperty(std::vector<base::string16>& properties, |
| ax::mojom::State state, |
| const char* uia_aria_property); |
| |
| // If the Html attribute |html_attribute_name| is present, add its value as a |
| // UIA AriaProperties Property with the name |uia_aria_property|. |
| void HtmlAttributeToUIAAriaProperty(std::vector<base::string16>& properties, |
| const char* html_attribute_name, |
| const char* uia_aria_property); |
| |
| // If the IntList attribute |attribute| is present, return an array |
| // of automation elements referenced by the ids in the |
| // IntList attribute. Otherwise return an empty array. |
| SAFEARRAY* CreateUIAElementsArrayForRelation( |
| const ax::mojom::IntListAttribute& attribute); |
| |
| // Return an array of automation elements given a vector |
| // of |AXNode| ids. |
| SAFEARRAY* CreateUIAElementsArrayFromIdVector(std::vector<int32_t>& ids); |
| |
| void AddAlertTarget(); |
| void RemoveAlertTarget(); |
| |
| // Return the text to use for IAccessibleText. |
| base::string16 TextForIAccessibleText(); |
| |
| // Search forwards (direction == 1) or backwards (direction == -1) |
| // from the given offset until the given boundary is found, and |
| // return the offset of that boundary. |
| LONG FindBoundary(const base::string16& text, |
| IA2TextBoundaryType ia2_boundary, |
| LONG start_offset, |
| TextBoundaryDirection direction); |
| |
| // Return true if the index represents a text character. |
| bool IsText(const base::string16& text, |
| size_t index, |
| bool is_indexed_from_end = false); |
| |
| // Many MSAA methods take a var_id parameter indicating that the operation |
| // should be performed on a particular child ID, rather than this object. |
| // This method tries to figure out the target object from |var_id| and |
| // returns a pointer to the target object if it exists, otherwise nullptr. |
| // Does not return a new reference. |
| AXPlatformNodeWin* GetTargetFromChildID(const VARIANT& var_id); |
| |
| // Returns true if this node is in a treegrid. |
| bool IsInTreeGrid(); |
| |
| // Helper method for returning selected indicies. It is expected that the |
| // caller ensures that the input has been validated. |
| HRESULT AllocateComArrayFromVector(std::vector<LONG>& results, |
| LONG max, |
| LONG** selected, |
| LONG* n_selected); |
| |
| bool IsAncestorComboBox(); |
| }; |
| |
| } // namespace ui |
| |
| #endif // UI_ACCESSIBILITY_PLATFORM_AX_PLATFORM_NODE_WIN_H_ |