qt-everywhere-src-5.15.1/qtdoc/doc/src/snippets/accessibilityslidersnippet.cpp - orbit - Git at Google

 /****************************************************************************
 **
 ** Copyright (C) 2016 The Qt Company Ltd.
 ** Contact: https://www.qt.io/licensing/
 **
 ** This file is part of the documentation of the Qt Toolkit.
 **
 ** $QT_BEGIN_LICENSE:BSD$
 ** Commercial License Usage
 ** Licensees holding valid commercial Qt licenses may use this file in
 ** accordance with the commercial license agreement provided with the
 ** Software or, alternatively, in accordance with the terms contained in
 ** a written agreement between you and The Qt Company. For licensing terms
 ** and conditions see https://www.qt.io/terms-conditions. For further
 ** information use the contact form at https://www.qt.io/contact-us.
 **
 ** BSD License Usage
 ** Alternatively, 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 The Qt Company Ltd 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<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 &params)
 {
     switch (method) {
     case ListSupportedMethods: {
         QSet<QAccessible::Method> set;
         set << ListSupportedMethods;
         return QVariant::fromValue(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());
 }
	/****************************************************************************
	**
	** Copyright (C) 2016 The Qt Company Ltd.
	** Contact: https://www.qt.io/licensing/
	**
	** This file is part of the documentation of the Qt Toolkit.
	**
	** $QT_BEGIN_LICENSE:BSD$
	** Commercial License Usage
	** Licensees holding valid commercial Qt licenses may use this file in
	** accordance with the commercial license agreement provided with the
	** Software or, alternatively, in accordance with the terms contained in
	** a written agreement between you and The Qt Company. For licensing terms
	** and conditions see https://www.qt.io/terms-conditions. For further
	** information use the contact form at https://www.qt.io/contact-us.
	**
	** BSD License Usage
	** Alternatively, 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 The Qt Company Ltd 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<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 &params)
	{
	switch (method) {
	case ListSupportedMethods: {
	QSet<QAccessible::Method> set;
	set << ListSupportedMethods;
	return QVariant::fromValue(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());
	}