/**************************************************************************** ** ** 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 documentation of the Qt Toolkit. ** ** $QT_BEGIN_LICENSE:BSD$ ** You may use this file under the terms of the BSD license as follows: ** ** "Redistribution and use in source and binary forms, with or without ** modification, are permitted provided that the following conditions are ** met: ** * Redistributions of source code must retain the above copyright ** notice, this list of conditions and the following disclaimer. ** * Redistributions in binary form must reproduce the above copyright ** notice, this list of conditions and the following disclaimer in ** the documentation and/or other materials provided with the ** distribution. ** * Neither the name of Nokia Corporation and its Subsidiary(-ies) nor ** the names of its contributors may be used to endorse or promote ** products derived from this software without specific prior written ** permission. ** ** THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS ** "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT ** LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR ** A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT ** OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, ** SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT ** LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, ** DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY ** THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT ** (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE ** OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE." ** $QT_END_LICENSE$ ** ****************************************************************************/ //! [0] QAccessibleSlider::QAccessibleSlider(QWidget *w) : QAccessibleAbstractSlider(w) { Q_ASSERT(slider()); addControllingSignal(QLatin1String("valueChanged(int)")); } //! [0] QSlider *QAccessibleSlider::slider() const { return qobject_cast(object()); } //! [1] QRect QAccessibleSlider::rect(int child) const { //! [1] QRect rect; if (!slider()->isVisible()) return rect; const QStyleOptionSlider option = qt_qsliderStyleOption(slider()); QRect srect = slider()->style()->subControlRect(QStyle::CC_Slider, &option, QStyle::SC_SliderHandle, slider()); //! [2] switch (child) { case PageLeft: if (slider()->orientation() == Qt::Vertical) rect = QRect(0, 0, slider()->width(), srect.y()); else rect = QRect(0, 0, srect.x(), slider()->height()); break; case Position: rect = srect; break; case PageRight: if (slider()->orientation() == Qt::Vertical) rect = QRect(0, srect.y() + srect.height(), slider()->width(), slider()->height()- srect.y() - srect.height()); else rect = QRect(srect.x() + srect.width(), 0, slider()->width() - srect.x() - srect.width(), slider()->height()); break; default: return QAccessibleAbstractSlider::rect(child); } //! [2] //! [3] QPoint tp = slider()->mapToGlobal(QPoint(0,0)); return QRect(tp.x() + rect.x(), tp.y() + rect.y(), rect.width(), rect.height()); } //! [3] int QAccessibleSlider::childCount() const { if (!slider()->isVisible()) return 0; return PageRight; } //! [4] QString QAccessibleSlider::text(Text t, int child) const { if (!slider()->isVisible()) return QString(); switch (t) { case Value: if (!child || child == 2) return QString::number(slider()->value()); return QString(); case Name: switch (child) { case PageLeft: return slider()->orientation() == Qt::Horizontal ? QSlider::tr("Page left") : QSlider::tr("Page up"); case Position: return QSlider::tr("Position"); case PageRight: return slider()->orientation() == Qt::Horizontal ? QSlider::tr("Page right") : QSlider::tr("Page down"); } break; default: break; } return QAccessibleAbstractSlider::text(t, child); } //! [4] //! [5] QAccessible::Role QAccessibleSlider::role(int child) const { switch (child) { case PageLeft: case PageRight: return PushButton; case Position: return Indicator; default: return Slider; } } //! [5] //! [6] QAccessible::State QAccessibleSlider::state(int child) const { const State parentState = QAccessibleAbstractSlider::state(0); //! [6] if (child == 0) return parentState; // Inherit the Invisible state from parent. State state = parentState & QAccessible::Invisible; // Disable left/right if we are at the minimum/maximum. const QSlider * const slider = QAccessibleSlider::slider(); //! [7] switch (child) { case PageLeft: if (slider->value() <= slider->minimum()) state |= Unavailable; break; case PageRight: if (slider->value() >= slider->maximum()) state |= Unavailable; break; case Position: default: break; } return state; } //! [7] int QAccessibleSlider::defaultAction(int child) const { switch (child) { case SliderSelf: return SetFocus; case PageLeft: return Press; case PageRight: return Press; } return 0; } // Name, Description, Value, Help, Accelerator static const char * const actionTexts[][5] = { {"Press", "Decreases the value of the slider", "", "", "Ctrl+L"}, {"Press", "Increaces the value of the slider", "", "", "Ctrl+R"} }; QString QAccessibleSlider::actionText(int action, Text text, int child) const { if (action != Press || child < 1 || child > 2) return QAccessibleAbstractSlider::actionText(action, text, child); return actionTexts[child - 1][t]; } bool QAccessibleSlider::doAction(int action, int child) { if (action != Press || child < 1 || child > 2) return false; if (child == PageLeft) slider()->setValue(slider()->value() - slider()->pageStep()); else slider()->setValue(slider()->value() + slider()->pageStep()); } QAccessibleAbstractSlider::QAccessibleAbstractSlider(QWidget *w, Role r) : QAccessibleWidgetEx(w, r) { Q_ASSERT(qobject_cast(w)); } QVariant QAccessibleAbstractSlider::invokeMethodEx(Method method, int child, const QVariantList ¶ms) { switch (method) { case ListSupportedMethods: { QSet set; set << ListSupportedMethods; return QVariant::fromValue(set | qvariant_cast >( QAccessibleWidgetEx::invokeMethodEx(method, child, params))); } default: return QAccessibleWidgetEx::invokeMethodEx(method, child, params); } } QVariant QAccessibleAbstractSlider::currentValue() { return abstractSlider()->value(); } void QAccessibleAbstractSlider::setCurrentValue(const QVariant &value) { abstractSlider()->setValue(value.toInt()); } QVariant QAccessibleAbstractSlider::maximumValue() { return abstractSlider()->maximum(); } QVariant QAccessibleAbstractSlider::minimumValue() { return abstractSlider()->minimum(); } QAbstractSlider *QAccessibleAbstractSlider::abstractSlider() const { return static_cast(object()); }