diff options
Diffstat (limited to 'src/gui/accessible/qaccessible2.cpp')
-rw-r--r-- | src/gui/accessible/qaccessible2.cpp | 317 |
1 files changed, 317 insertions, 0 deletions
diff --git a/src/gui/accessible/qaccessible2.cpp b/src/gui/accessible/qaccessible2.cpp new file mode 100644 index 0000000000..aef7e1af75 --- /dev/null +++ b/src/gui/accessible/qaccessible2.cpp @@ -0,0 +1,317 @@ +/**************************************************************************** +** +** Copyright (C) 2011 Nokia Corporation and/or its subsidiary(-ies). +** All rights reserved. +** Contact: Nokia Corporation (qt-info@nokia.com) +** +** This file is part of the QtGui module of the Qt Toolkit. +** +** $QT_BEGIN_LICENSE:LGPL$ +** GNU Lesser General Public License Usage +** This file may be used under the terms of the GNU Lesser General Public +** License version 2.1 as published by the Free Software Foundation and +** appearing in the file LICENSE.LGPL included in the packaging of this +** file. Please review the following information to ensure the GNU Lesser +** General Public License version 2.1 requirements will be met: +** http://www.gnu.org/licenses/old-licenses/lgpl-2.1.html. +** +** In addition, as a special exception, Nokia gives you certain additional +** rights. These rights are described in the Nokia Qt LGPL Exception +** version 1.1, included in the file LGPL_EXCEPTION.txt in this package. +** +** GNU General Public License Usage +** Alternatively, this file may be used under the terms of the GNU General +** Public License version 3.0 as published by the Free Software Foundation +** and appearing in the file LICENSE.GPL included in the packaging of this +** file. Please review the following information to ensure the GNU General +** Public License version 3.0 requirements will be met: +** http://www.gnu.org/copyleft/gpl.html. +** +** Other Usage +** Alternatively, this file may be used in accordance with the terms and +** conditions contained in a signed written agreement between you and Nokia. +** +** +** +** +** +** $QT_END_LICENSE$ +** +****************************************************************************/ + +#include "qaccessible2.h" +#include <QtGui/QGuiApplication> +#include "qclipboard.h" +#include "qtextboundaryfinder.h" + +#ifndef QT_NO_ACCESSIBILITY + +QT_BEGIN_NAMESPACE + +/*! + \namespace QAccessible2 + \ingroup accessibility + \internal + \preliminary + + \brief The QAccessible2 namespace defines constants relating to + IAccessible2-based interfaces + + \link http://www.linux-foundation.org/en/Accessibility/IAccessible2 IAccessible2 Specification \endlink +*/ + +/*! + \class QAccessibleTextInterface + + \ingroup accessibility + \internal + \preliminary + + \brief The QAccessibleTextInterface class implements support for + the IAccessibleText interface. + + \link http://www.linux-foundation.org/en/Accessibility/IAccessible2 IAccessible2 Specification \endlink +*/ + +/*! + \class QAccessibleEditableTextInterface + \ingroup accessibility + \internal + \preliminary + + \brief The QAccessibleEditableTextInterface class implements support for + the IAccessibleEditableText interface. + + \link http://www.linux-foundation.org/en/Accessibility/IAccessible2 IAccessible2 Specification \endlink +*/ + +/*! + \class QAccessibleSimpleEditableTextInterface + \ingroup accessibility + \internal + \preliminary + + \brief The QAccessibleSimpleEditableTextInterface class is a convenience class for + text-based widgets. + + \link http://www.linux-foundation.org/en/Accessibility/IAccessible2 IAccessible2 Specification \endlink +*/ + +/*! + \class QAccessibleValueInterface + \ingroup accessibility + \internal + \preliminary + + \brief The QAccessibleValueInterface class implements support for + the IAccessibleValue interface. + + \link http://www.linux-foundation.org/en/Accessibility/IAccessible2 IAccessible2 Specification \endlink +*/ + +/*! + \class QAccessibleActionInterface + \ingroup accessibility + \internal + \preliminary + + \brief The QAccessibleActionInterface class implements support for + the IAccessibleAction interface. + + \link http://www.linux-foundation.org/en/Accessibility/IAccessible2 IAccessible2 Specification \endlink +*/ + +/*! + \class QAccessibleImageInterface + \ingroup accessibility + \internal + \preliminary + + \brief The QAccessibleImageInterface class implements support for + the IAccessibleImage interface. + + \link http://www.linux-foundation.org/en/Accessibility/IAccessible2 IAccessible2 Specification \endlink +*/ + + +/*! + \internal +*/ +QString Q_GUI_EXPORT qTextBeforeOffsetFromString(int offset, QAccessible2::BoundaryType boundaryType, + int *startOffset, int *endOffset, const QString& text) +{ + QTextBoundaryFinder::BoundaryType type; + switch (boundaryType) { + case QAccessible2::CharBoundary: + type = QTextBoundaryFinder::Grapheme; + break; + case QAccessible2::WordBoundary: + type = QTextBoundaryFinder::Word; + break; + case QAccessible2::SentenceBoundary: + type = QTextBoundaryFinder::Sentence; + break; + default: + // in any other case return the whole line + *startOffset = 0; + *endOffset = text.length(); + return text; + } + + QTextBoundaryFinder boundary(type, text); + boundary.setPosition(offset); + + if (!boundary.isAtBoundary()) { + boundary.toPreviousBoundary(); + } + boundary.toPreviousBoundary(); + *startOffset = boundary.position(); + boundary.toNextBoundary(); + *endOffset = boundary.position(); + + return text.mid(*startOffset, *endOffset - *startOffset); +} + +/*! + \internal +*/ +QString Q_GUI_EXPORT qTextAfterOffsetFromString(int offset, QAccessible2::BoundaryType boundaryType, + int *startOffset, int *endOffset, const QString& text) +{ + QTextBoundaryFinder::BoundaryType type; + switch (boundaryType) { + case QAccessible2::CharBoundary: + type = QTextBoundaryFinder::Grapheme; + break; + case QAccessible2::WordBoundary: + type = QTextBoundaryFinder::Word; + break; + case QAccessible2::SentenceBoundary: + type = QTextBoundaryFinder::Sentence; + break; + default: + // in any other case return the whole line + *startOffset = 0; + *endOffset = text.length(); + return text; + } + + QTextBoundaryFinder boundary(type, text); + boundary.setPosition(offset); + + boundary.toNextBoundary(); + *startOffset = boundary.position(); + boundary.toNextBoundary(); + *endOffset = boundary.position(); + + return text.mid(*startOffset, *endOffset - *startOffset); +} + +/*! + \internal +*/ +QString Q_GUI_EXPORT qTextAtOffsetFromString(int offset, QAccessible2::BoundaryType boundaryType, + int *startOffset, int *endOffset, const QString& text) +{ + QTextBoundaryFinder::BoundaryType type; + switch (boundaryType) { + case QAccessible2::CharBoundary: + type = QTextBoundaryFinder::Grapheme; + break; + case QAccessible2::WordBoundary: + type = QTextBoundaryFinder::Word; + break; + case QAccessible2::SentenceBoundary: + type = QTextBoundaryFinder::Sentence; + break; + default: + // in any other case return the whole line + *startOffset = 0; + *endOffset = text.length(); + return text; + } + + QTextBoundaryFinder boundary(type, text); + boundary.setPosition(offset); + + if (!boundary.isAtBoundary()) { + boundary.toPreviousBoundary(); + } + *startOffset = boundary.position(); + boundary.toNextBoundary(); + *endOffset = boundary.position(); + + return text.mid(*startOffset, *endOffset - *startOffset); +} + +QAccessibleSimpleEditableTextInterface::QAccessibleSimpleEditableTextInterface( + QAccessibleInterface *accessibleInterface) + : iface(accessibleInterface) +{ + Q_ASSERT(iface); +} + +#ifndef QT_NO_CLIPBOARD +static QString textForRange(QAccessibleInterface *iface, int startOffset, int endOffset) +{ + return iface->text(QAccessible::Value, 0).mid(startOffset, endOffset - startOffset); +} +#endif + +void QAccessibleSimpleEditableTextInterface::copyText(int startOffset, int endOffset) +{ +#ifdef QT_NO_CLIPBOARD + Q_UNUSED(startOffset); + Q_UNUSED(endOffset); +#else + QGuiApplication::clipboard()->setText(textForRange(iface, startOffset, endOffset)); +#endif +} + +void QAccessibleSimpleEditableTextInterface::deleteText(int startOffset, int endOffset) +{ + QString txt = iface->text(QAccessible::Value, 0); + txt.remove(startOffset, endOffset - startOffset); + iface->setText(QAccessible::Value, 0, txt); +} + +void QAccessibleSimpleEditableTextInterface::insertText(int offset, const QString &text) +{ + QString txt = iface->text(QAccessible::Value, 0); + txt.insert(offset, text); + iface->setText(QAccessible::Value, 0, txt); +} + +void QAccessibleSimpleEditableTextInterface::cutText(int startOffset, int endOffset) +{ +#ifdef QT_NO_CLIPBOARD + Q_UNUSED(startOffset); + Q_UNUSED(endOffset); +#else + QString sub = textForRange(iface, startOffset, endOffset); + deleteText(startOffset, endOffset); + QGuiApplication::clipboard()->setText(sub); +#endif +} + +void QAccessibleSimpleEditableTextInterface::pasteText(int offset) +{ +#ifdef QT_NO_CLIPBOARD + Q_UNUSED(offset); +#else + QString txt = iface->text(QAccessible::Value, 0); + txt.insert(offset, QGuiApplication::clipboard()->text()); + iface->setText(QAccessible::Value, 0, txt); +#endif +} + +void QAccessibleSimpleEditableTextInterface::replaceText(int startOffset, int endOffset, const QString &text) +{ + QString txt = iface->text(QAccessible::Value, 0); + txt.replace(startOffset, endOffset - startOffset, text); + iface->setText(QAccessible::Value, 0, txt); +} + +QT_END_NAMESPACE + +#endif // QT_NO_ACCESSIBILITY |