/****************************************************************************
**
** Copyright (C) 2009 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:LGPL$
** No Commercial Usage
** This file contains pre-release code and may not be distributed.
** You may use this file in accordance with the terms and conditions
** contained in the Technology Preview License Agreement accompanying
** this package.
**
** GNU Lesser General Public License Usage
** Alternatively, 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.
**
** If you have questions regarding the use of this file, please contact
** Nokia at qt-info@nokia.com.
**
**
**
**
**
**
**
**
** $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<QSlider*>(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<QAbstractSlider *>(w));
}
QVariant QAccessibleAbstractSlider::invokeMethodEx(Method method, int child, const QVariantList ¶ms)
{
switch (method) {
case ListSupportedMethods: {
QSet<QAccessible::Method> set;
set << ListSupportedMethods;
return qVariantFromValue(set | qvariant_cast<QSet<QAccessible::Method> >(
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<QAbstractSlider *>(object());
}