/**************************************************************************** ** ** Copyright (C) 2017 The Qt Company Ltd. ** Contact: https://www.qt.io/licensing/ ** ** This file is part of the plugins of the Qt Toolkit. ** ** $QT_BEGIN_LICENSE:LGPL$ ** Commercial License Usage ** Licensees holding valid commercial Qt licenses may use this file in ** accordance with the commercial license agreement provided with the ** Software or, alternatively, in accordance with the terms contained in ** a written agreement between you and The Qt Company. For licensing terms ** and conditions see https://www.qt.io/terms-conditions. For further ** information use the contact form at https://www.qt.io/contact-us. ** ** GNU Lesser General Public License Usage ** Alternatively, this file may be used under the terms of the GNU Lesser ** General Public License version 3 as published by the Free Software ** Foundation and appearing in the file LICENSE.LGPL3 included in the ** packaging of this file. Please review the following information to ** ensure the GNU Lesser General Public License version 3 requirements ** will be met: https://www.gnu.org/licenses/lgpl-3.0.html. ** ** GNU General Public License Usage ** Alternatively, this file may be used under the terms of the GNU ** General Public License version 2.0 or (at your option) the GNU General ** Public license version 3 or any later version approved by the KDE Free ** Qt Foundation. The licenses are as published by the Free Software ** Foundation and appearing in the file LICENSE.GPL2 and LICENSE.GPL3 ** included in the packaging of this file. Please review the following ** information to ensure the GNU General Public License requirements will ** be met: https://www.gnu.org/licenses/gpl-2.0.html and ** https://www.gnu.org/licenses/gpl-3.0.html. ** ** $QT_END_LICENSE$ ** ****************************************************************************/ #include #if QT_CONFIG(accessibility) #include "qwindowsuiatextprovider.h" #include "qwindowsuiautils.h" #include "qwindowscontext.h" #include #include #include QT_BEGIN_NAMESPACE using namespace QWindowsUiAutomation; QWindowsUiaTextProvider::QWindowsUiaTextProvider(QAccessible::Id id) : QWindowsUiaBaseProvider(id) { } QWindowsUiaTextProvider::~QWindowsUiaTextProvider() { } HRESULT STDMETHODCALLTYPE QWindowsUiaTextProvider::QueryInterface(REFIID iid, LPVOID *iface) { qCDebug(lcQpaUiAutomation) << __FUNCTION__ << this; if (!iface) return E_INVALIDARG; *iface = nullptr; const bool result = qWindowsComQueryUnknownInterfaceMulti(this, iid, iface) || qWindowsComQueryInterface(this, iid, iface) || qWindowsComQueryInterface(this, iid, iface); return result ? S_OK : E_NOINTERFACE; } // Returns an array of providers for the selected text ranges. HRESULT STDMETHODCALLTYPE QWindowsUiaTextProvider::GetSelection(SAFEARRAY **pRetVal) { qCDebug(lcQpaUiAutomation) << __FUNCTION__ << this; if (!pRetVal) return E_INVALIDARG; *pRetVal = nullptr; QAccessibleInterface *accessible = accessibleInterface(); if (!accessible) return UIA_E_ELEMENTNOTAVAILABLE; QAccessibleTextInterface *textInterface = accessible->textInterface(); if (!textInterface) return UIA_E_ELEMENTNOTAVAILABLE; int selCount = textInterface->selectionCount(); if (selCount > 0) { // Build a safe array with the text range providers. if ((*pRetVal = SafeArrayCreateVector(VT_UNKNOWN, 0, selCount))) { for (LONG i = 0; i < selCount; ++i) { int startOffset = 0, endOffset = 0; textInterface->selection((int)i, &startOffset, &endOffset); QWindowsUiaTextRangeProvider *textRangeProvider = new QWindowsUiaTextRangeProvider(id(), startOffset, endOffset); SafeArrayPutElement(*pRetVal, &i, static_cast(textRangeProvider)); textRangeProvider->Release(); } } } else { // If there is no selection, we return an array with a single degenerate (empty) text range at the cursor position. if ((*pRetVal = SafeArrayCreateVector(VT_UNKNOWN, 0, 1))) { LONG i = 0; int cursorPosition = textInterface->cursorPosition(); QWindowsUiaTextRangeProvider *textRangeProvider = new QWindowsUiaTextRangeProvider(id(), cursorPosition, cursorPosition); SafeArrayPutElement(*pRetVal, &i, static_cast(textRangeProvider)); textRangeProvider->Release(); } } return S_OK; } // Returns an array of providers for the visible text ranges. HRESULT STDMETHODCALLTYPE QWindowsUiaTextProvider::GetVisibleRanges(SAFEARRAY **pRetVal) { qCDebug(lcQpaUiAutomation) << __FUNCTION__ << this; if (!pRetVal) return E_INVALIDARG; *pRetVal = nullptr; QAccessibleInterface *accessible = accessibleInterface(); if (!accessible) return UIA_E_ELEMENTNOTAVAILABLE; QAccessibleTextInterface *textInterface = accessible->textInterface(); if (!textInterface) return UIA_E_ELEMENTNOTAVAILABLE; // Considering the entire text as visible. if ((*pRetVal = SafeArrayCreateVector(VT_UNKNOWN, 0, 1))) { LONG i = 0; QWindowsUiaTextRangeProvider *textRangeProvider = new QWindowsUiaTextRangeProvider(id(), 0, textInterface->characterCount()); SafeArrayPutElement(*pRetVal, &i, static_cast(textRangeProvider)); textRangeProvider->Release(); } return S_OK; } HRESULT STDMETHODCALLTYPE QWindowsUiaTextProvider::RangeFromChild(IRawElementProviderSimple * /*childElement*/, ITextRangeProvider **pRetVal) { qCDebug(lcQpaUiAutomation) << __FUNCTION__ << this; if (!pRetVal) return E_INVALIDARG; *pRetVal = nullptr; // No children supported. return S_OK; } // Returns a degenerate text range at the specified point. HRESULT STDMETHODCALLTYPE QWindowsUiaTextProvider::RangeFromPoint(UiaPoint point, ITextRangeProvider **pRetVal) { qCDebug(lcQpaUiAutomation) << __FUNCTION__ << this; if (!pRetVal) return E_INVALIDARG; *pRetVal = nullptr; QAccessibleInterface *accessible = accessibleInterface(); if (!accessible) return UIA_E_ELEMENTNOTAVAILABLE; QAccessibleTextInterface *textInterface = accessible->textInterface(); if (!textInterface) return UIA_E_ELEMENTNOTAVAILABLE; QWindow *window = windowForAccessible(accessible); if (!window) return UIA_E_ELEMENTNOTAVAILABLE; QPoint pt; nativeUiaPointToPoint(point, window, &pt); int offset = textInterface->offsetAtPoint(pt); if ((offset >= 0) && (offset < textInterface->characterCount())) { *pRetVal = new QWindowsUiaTextRangeProvider(id(), offset, offset); } return S_OK; } // Returns a text range provider for the entire text. HRESULT STDMETHODCALLTYPE QWindowsUiaTextProvider::get_DocumentRange(ITextRangeProvider **pRetVal) { qCDebug(lcQpaUiAutomation) << __FUNCTION__ << this; if (!pRetVal) return E_INVALIDARG; *pRetVal = nullptr; QAccessibleInterface *accessible = accessibleInterface(); if (!accessible) return UIA_E_ELEMENTNOTAVAILABLE; QAccessibleTextInterface *textInterface = accessible->textInterface(); if (!textInterface) return UIA_E_ELEMENTNOTAVAILABLE; *pRetVal = new QWindowsUiaTextRangeProvider(id(), 0, textInterface->characterCount()); return S_OK; } // Currently supporting single selection. HRESULT STDMETHODCALLTYPE QWindowsUiaTextProvider::get_SupportedTextSelection(SupportedTextSelection *pRetVal) { qCDebug(lcQpaUiAutomation) << __FUNCTION__ << this; if (!pRetVal) return E_INVALIDARG; *pRetVal = SupportedTextSelection_Single; return S_OK; } // Not supporting annotations. HRESULT STDMETHODCALLTYPE QWindowsUiaTextProvider::RangeFromAnnotation(IRawElementProviderSimple * /*annotationElement*/, ITextRangeProvider **pRetVal) { qCDebug(lcQpaUiAutomation) << __FUNCTION__ << this; if (!pRetVal) return E_INVALIDARG; *pRetVal = nullptr; return S_OK; } HRESULT STDMETHODCALLTYPE QWindowsUiaTextProvider::GetCaretRange(BOOL *isActive, ITextRangeProvider **pRetVal) { qCDebug(lcQpaUiAutomation) << __FUNCTION__ << this; if (!isActive || !pRetVal) return E_INVALIDARG; *isActive = FALSE; *pRetVal = nullptr; QAccessibleInterface *accessible = accessibleInterface(); if (!accessible) return UIA_E_ELEMENTNOTAVAILABLE; QAccessibleTextInterface *textInterface = accessible->textInterface(); if (!textInterface) return UIA_E_ELEMENTNOTAVAILABLE; *isActive = accessible->state().focused; int cursorPosition = textInterface->cursorPosition(); *pRetVal = new QWindowsUiaTextRangeProvider(id(), cursorPosition, cursorPosition); return S_OK; } QT_END_NAMESPACE #endif // QT_CONFIG(accessibility)