Reviewer: Lauro Moura <lauro.neto@openbossa.org>
Luciano Wolf <luciano.wolf@openbossa.org>
262 lines
7.6 KiB
C++
262 lines
7.6 KiB
C++
/****************************************************************************
|
|
**
|
|
** Copyright (C) 2009 Nokia Corporation and/or its subsidiary(-ies).
|
|
** Contact: Nokia Corporation (qt-info@nokia.com)
|
|
**
|
|
** This file is part of the documentation of the Qt Toolkit.
|
|
**
|
|
** $QT_BEGIN_LICENSE:LGPL$
|
|
** Commercial Usage
|
|
** Licensees holding valid Qt Commercial licenses may use this file in
|
|
** accordance with the Qt Commercial License Agreement provided with the
|
|
** Software or, alternatively, in accordance with the terms contained in
|
|
** a written agreement between you and Nokia.
|
|
**
|
|
** 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.0, 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.
|
|
**
|
|
** If you are unsure which license is appropriate for your use, please
|
|
** contact the sales department at http://www.qtsoftware.com/contact.
|
|
** $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());
|
|
}
|