/**************************************************************************** ** ** Copyright (C) 2012 Nokia Corporation and/or its subsidiary(-ies). ** Contact: http://www.qt-project.org/ ** ** This file is part of the QtQml 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 #include "qqmlaccessible.h" #ifndef QT_NO_ACCESSIBILITY QT_BEGIN_NAMESPACE QString Q_GUI_EXPORT qTextBeforeOffsetFromString(int offset, QAccessible2::BoundaryType boundaryType, int *startOffset, int *endOffset, const QString& text); QString Q_GUI_EXPORT qTextAtOffsetFromString(int offset, QAccessible2::BoundaryType boundaryType, int *startOffset, int *endOffset, const QString& text); QString Q_GUI_EXPORT qTextAfterOffsetFromString(int offset, QAccessible2::BoundaryType boundaryType, int *startOffset, int *endOffset, const QString& text); QQmlAccessible::QQmlAccessible(QObject *object) :QAccessibleObject(object) { } void *QQmlAccessible::interface_cast(QAccessible::InterfaceType t) { if (t == QAccessible::ActionInterface) return static_cast(this); return QAccessibleObject::interface_cast(t); } QQmlAccessible::~QQmlAccessible() { } QAccessibleInterface *QQmlAccessible::childAt(int x, int y) const { // Note that this function will disregard stacking order. // (QAccessibleQuickView::childAt() does this correctly and more efficient) // If the item clips its children, we can return early if the coordinate is outside its rect if (clipsChildren()) { if (!rect().contains(x, y)) return 0; } for (int i = childCount() - 1; i >= 0; --i) { QAccessibleInterface *childIface = child(i); if (childIface && !childIface->state().invisible) { if (childIface->rect().contains(x, y)) return childIface; } delete childIface; } return 0; } QAccessible::State QQmlAccessible::state() const { QAccessible::State state; //QRect viewRect(QPoint(0, 0), m_implementation->size()); //QRect itemRect(m_item->scenePos().toPoint(), m_item->boundingRect().size().toSize()); QRect viewRect_ = viewRect(); QRect itemRect = rect(); // qDebug() << "viewRect" << viewRect << "itemRect" << itemRect; // error case: if (viewRect_.isNull() || itemRect.isNull()) { state.invisible = true; } if (!viewRect_.intersects(itemRect)) { state.offscreen = true; // state.invisible = true; // no set at this point to ease development } if (!object()->property("visible").toBool() || qFuzzyIsNull(object()->property("opacity").toDouble())) { state.invisible = true; } if ((role() == QAccessible::CheckBox || role() == QAccessible::RadioButton) && object()->property("checked").toBool()) { state.checked = true; } if (role() == QAccessible::EditableText) state.focusable = true; //qDebug() << "state?" << m_item->property("state").toString() << m_item->property("status").toString() << m_item->property("visible").toString(); return state; } QStringList QQmlAccessible::actionNames() const { QStringList actions; switch (role()) { case QAccessible::PushButton: actions << QAccessibleActionInterface::pressAction(); break; case QAccessible::RadioButton: case QAccessible::CheckBox: actions << QAccessibleActionInterface::toggleAction(); break; case QAccessible::Slider: case QAccessible::SpinBox: case QAccessible::ScrollBar: actions << QAccessibleActionInterface::increaseAction() << QAccessibleActionInterface::decreaseAction(); break; default: break; } return actions; } void QQmlAccessible::doAction(const QString &actionName) { // Look for and call the accessible[actionName]Action() function on the item. // This allows for overriding the default action handling. const QByteArray functionName = "accessible" + actionName.toLatin1() + "Action"; if (object()->metaObject()->indexOfMethod(functionName + "()") != -1) { QMetaObject::invokeMethod(object(), functionName); return; } // Role-specific default action handling follows. Items are excepted to provide // properties according to role conventions. These will then be read and/or updated // by the accessibility system. // Checkable roles : checked // Value-based roles : (via the value interface: value, minimumValue, maximumValue), stepSize switch (role()) { case QAccessible::RadioButton: case QAccessible::CheckBox: { QVariant checked = object()->property("checked"); if (checked.isValid()) { if (actionName == QAccessibleActionInterface::toggleAction()) { object()->setProperty("checked", QVariant(!checked.toBool())); } } break; } case QAccessible::Slider: case QAccessible::SpinBox: case QAccessible::Dial: case QAccessible::ScrollBar: { if (actionName != QAccessibleActionInterface::increaseAction() && actionName != QAccessibleActionInterface::decreaseAction()) break; // Update the value using QAccessibleValueInterface, respecting // the minimum and maximum value (if set). Also check for and // use the "stepSize" property on the item if (QAccessibleValueInterface *valueIface = valueInterface()) { QVariant valueV = valueIface->currentValue(); qreal newValue = valueV.toInt(); QVariant stepSizeV = object()->property("stepSize"); qreal stepSize = stepSizeV.isValid() ? stepSizeV.toReal() : qreal(1.0); if (actionName == QAccessibleActionInterface::increaseAction()) { newValue += stepSize; } else { newValue -= stepSize; } QVariant minimumValueV = valueIface->minimumValue(); if (minimumValueV.isValid()) { newValue = qMax(newValue, minimumValueV.toReal()); } QVariant maximumValueV = valueIface->maximumValue(); if (maximumValueV.isValid()) { newValue = qMin(newValue, maximumValueV.toReal()); } valueIface->setCurrentValue(QVariant(newValue)); } break; } default: break; } } QStringList QQmlAccessible::keyBindingsForAction(const QString &actionName) const { Q_UNUSED(actionName) return QStringList(); } QT_END_NAMESPACE #endif // QT_NO_ACCESSIBILITY