1 /****************************************************************************
2 **
3 ** Copyright (C) 2017 The Qt Company Ltd.
4 ** Contact: https://www.qt.io/licensing/
5 **
6 ** This file is part of the plugins of the Qt Toolkit.
7 **
8 ** $QT_BEGIN_LICENSE:LGPL$
9 ** Commercial License Usage
10 ** Licensees holding valid commercial Qt licenses may use this file in
11 ** accordance with the commercial license agreement provided with the
12 ** Software or, alternatively, in accordance with the terms contained in
13 ** a written agreement between you and The Qt Company. For licensing terms
14 ** and conditions see https://www.qt.io/terms-conditions. For further
15 ** information use the contact form at https://www.qt.io/contact-us.
16 **
17 ** GNU Lesser General Public License Usage
18 ** Alternatively, this file may be used under the terms of the GNU Lesser
19 ** General Public License version 3 as published by the Free Software
20 ** Foundation and appearing in the file LICENSE.LGPL3 included in the
21 ** packaging of this file. Please review the following information to
22 ** ensure the GNU Lesser General Public License version 3 requirements
23 ** will be met: https://www.gnu.org/licenses/lgpl-3.0.html.
24 **
25 ** GNU General Public License Usage
26 ** Alternatively, this file may be used under the terms of the GNU
27 ** General Public License version 2.0 or (at your option) the GNU General
28 ** Public license version 3 or any later version approved by the KDE Free
29 ** Qt Foundation. The licenses are as published by the Free Software
30 ** Foundation and appearing in the file LICENSE.GPL2 and LICENSE.GPL3
31 ** included in the packaging of this file. Please review the following
32 ** information to ensure the GNU General Public License requirements will
33 ** be met: https://www.gnu.org/licenses/gpl-2.0.html and
34 ** https://www.gnu.org/licenses/gpl-3.0.html.
35 **
36 ** $QT_END_LICENSE$
37 **
38 ****************************************************************************/
39
40 #include <QtGui/qtguiglobal.h>
41 #if QT_CONFIG(accessibility)
42
43 #include "qwindowsuiatableprovider.h"
44 #include "qwindowsuiamainprovider.h"
45 #include "qwindowsuiautils.h"
46 #include "qwindowscontext.h"
47
48 #include <QtGui/qaccessible.h>
49 #include <QtCore/qloggingcategory.h>
50 #include <QtCore/qstring.h>
51
52 QT_BEGIN_NAMESPACE
53
54 using namespace QWindowsUiAutomation;
55
56
QWindowsUiaTableProvider(QAccessible::Id id)57 QWindowsUiaTableProvider::QWindowsUiaTableProvider(QAccessible::Id id) :
58 QWindowsUiaBaseProvider(id)
59 {
60 }
61
~QWindowsUiaTableProvider()62 QWindowsUiaTableProvider::~QWindowsUiaTableProvider()
63 {
64 }
65
66 // Gets the providers for all the row headers in the table.
GetRowHeaders(SAFEARRAY ** pRetVal)67 HRESULT STDMETHODCALLTYPE QWindowsUiaTableProvider::GetRowHeaders(SAFEARRAY **pRetVal)
68 {
69 qCDebug(lcQpaUiAutomation) << __FUNCTION__;
70
71 if (!pRetVal)
72 return E_INVALIDARG;
73 *pRetVal = nullptr;
74
75 QAccessibleInterface *accessible = accessibleInterface();
76 if (!accessible)
77 return UIA_E_ELEMENTNOTAVAILABLE;
78
79 QAccessibleTableInterface *tableInterface = accessible->tableInterface();
80 if (!tableInterface)
81 return UIA_E_ELEMENTNOTAVAILABLE;
82
83 QList<QAccessibleInterface *> headers;
84
85 for (int i = 0; i < tableInterface->rowCount(); ++i) {
86 if (QAccessibleInterface *cell = tableInterface->cellAt(i, 0)) {
87 if (QAccessibleTableCellInterface *tableCellInterface = cell->tableCellInterface()) {
88 headers.append(tableCellInterface->rowHeaderCells());
89 }
90 }
91 }
92 if ((*pRetVal = SafeArrayCreateVector(VT_UNKNOWN, 0, headers.size()))) {
93 for (LONG i = 0; i < headers.size(); ++i) {
94 if (QWindowsUiaMainProvider *headerProvider = QWindowsUiaMainProvider::providerForAccessible(headers.at(i))) {
95 SafeArrayPutElement(*pRetVal, &i, static_cast<IRawElementProviderSimple *>(headerProvider));
96 headerProvider->Release();
97 }
98 }
99 }
100 return S_OK;
101 }
102
103 // Gets the providers for all the column headers in the table.
GetColumnHeaders(SAFEARRAY ** pRetVal)104 HRESULT STDMETHODCALLTYPE QWindowsUiaTableProvider::GetColumnHeaders(SAFEARRAY **pRetVal)
105 {
106 qCDebug(lcQpaUiAutomation) << __FUNCTION__;
107
108 if (!pRetVal)
109 return E_INVALIDARG;
110 *pRetVal = nullptr;
111
112 QAccessibleInterface *accessible = accessibleInterface();
113 if (!accessible)
114 return UIA_E_ELEMENTNOTAVAILABLE;
115
116 QAccessibleTableInterface *tableInterface = accessible->tableInterface();
117 if (!tableInterface)
118 return UIA_E_ELEMENTNOTAVAILABLE;
119
120 QList<QAccessibleInterface *> headers;
121
122 for (int i = 0; i < tableInterface->columnCount(); ++i) {
123 if (QAccessibleInterface *cell = tableInterface->cellAt(0, i)) {
124 if (QAccessibleTableCellInterface *tableCellInterface = cell->tableCellInterface()) {
125 headers.append(tableCellInterface->columnHeaderCells());
126 }
127 }
128 }
129 if ((*pRetVal = SafeArrayCreateVector(VT_UNKNOWN, 0, headers.size()))) {
130 for (LONG i = 0; i < headers.size(); ++i) {
131 if (QWindowsUiaMainProvider *headerProvider = QWindowsUiaMainProvider::providerForAccessible(headers.at(i))) {
132 SafeArrayPutElement(*pRetVal, &i, static_cast<IRawElementProviderSimple *>(headerProvider));
133 headerProvider->Release();
134 }
135 }
136 }
137 return S_OK;
138 }
139
140 // Returns the primary direction of traversal for the table.
get_RowOrColumnMajor(enum RowOrColumnMajor * pRetVal)141 HRESULT STDMETHODCALLTYPE QWindowsUiaTableProvider::get_RowOrColumnMajor(enum RowOrColumnMajor *pRetVal)
142 {
143 qCDebug(lcQpaUiAutomation) << __FUNCTION__;
144
145 if (!pRetVal)
146 return E_INVALIDARG;
147 *pRetVal = RowOrColumnMajor_Indeterminate;
148 return S_OK;
149 }
150
151 QT_END_NAMESPACE
152
153 #endif // QT_CONFIG(accessibility)
154