QAccessibleValueInterface Class

The QAccessibleValueInterface class implements support for objects that manipulate a value. More...

Header: #include <QAccessibleValueInterface>
CMake: find_package(Qt6 REQUIRED COMPONENTS Gui)
target_link_libraries(mytarget PRIVATE Qt6::Gui)
qmake: QT += gui

Public Functions

virtual ~QAccessibleValueInterface()
virtual QVariant currentValue() const = 0
virtual QVariant maximumValue() const = 0
virtual QVariant minimumStepSize() const = 0
virtual QVariant minimumValue() const = 0
virtual void setCurrentValue(const QVariant &value) = 0

Detailed Description

This interface should be implemented by accessible objects that represent a value. Examples are spinner, slider, dial and scroll bar.

Instead of forcing the user to deal with the individual parts of the widgets, this interface gives an easier approach to the kind of widget it represents.

Usually this interface is implemented by classes that also implement QAccessibleInterface.

IAccessible2 Specification

Member Function Documentation

[virtual noexcept] QAccessibleValueInterface::~QAccessibleValueInterface()

Destroys the QAccessibleValueInterface.

[pure virtual] QVariant QAccessibleValueInterface::currentValue() const

Returns the current value of the widget. This is usually a double or int.

See also setCurrentValue().

[pure virtual] QVariant QAccessibleValueInterface::maximumValue() const

Returns the maximum value this object accepts.

See also minimumValue() and currentValue().

[pure virtual] QVariant QAccessibleValueInterface::minimumStepSize() const

Returns the minimum step size for the accessible. This is the smallest increment that makes sense when changing the value. When programmatically changing the value it should always be a multiple of the minimum step size.

Some tools use this value even when the setCurrentValue does not perform any action. Progress bars for example are read-only but should return their range divided by 100.

[pure virtual] QVariant QAccessibleValueInterface::minimumValue() const

Returns the minimum value this object accepts.

See also maximumValue() and currentValue().

[pure virtual] void QAccessibleValueInterface::setCurrentValue(const QVariant &value)

Sets the value. If the desired value is out of the range of permissible values, this call will be ignored.

See also currentValue(), minimumValue(), and maximumValue().

© 2024 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.