QAccessibleSelectionInterface Class

The QAccessibleSelectionInterface class implements support for selection handling. More...

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

This class is under development and is subject to change.

Public Functions

virtual ~QAccessibleSelectionInterface()
virtual bool clear() = 0
virtual bool isSelected(QAccessibleInterface *childItem) const
virtual bool select(QAccessibleInterface *childItem) = 0
virtual bool selectAll() = 0
virtual QAccessibleInterface *selectedItem(int selectionIndex) const
virtual int selectedItemCount() const = 0
virtual QList<QAccessibleInterface *> selectedItems() const = 0
virtual bool unselect(QAccessibleInterface *childItem) = 0

Detailed Description

It provides methods for both, retrieving the current selection as well as modifying the selection.

Only selections of direct children are supported.

Member Function Documentation

[virtual] QAccessibleSelectionInterface::~QAccessibleSelectionInterface()

Destroys the QAccessibleSelectionInterface.

[pure virtual] bool QAccessibleSelectionInterface::clear()

Unselects all accessible child items.

Returns whether all accessible child items have actually been removed from the selection, i.e. whether the selection is empty after this method has been called.

[virtual] bool QAccessibleSelectionInterface::isSelected(QAccessibleInterface *childItem) const

Returns whether childItem is part of the current selection.

The default implementation checks whether childItem is contained in the list of items retrieved by QAccessibleSelectionInterface::selectedItems.

[pure virtual] bool QAccessibleSelectionInterface::select(QAccessibleInterface *childItem)

Adds childItem to the selection. Returns whether childItem has actually been added to the selection.

For implementations that only allow single selections, this may replace the current selection.

[pure virtual] bool QAccessibleSelectionInterface::selectAll()

Selects all accessible child items.

Returns whether all accessible child items have actually been added to the selection.

[virtual] QAccessibleInterface *QAccessibleSelectionInterface::selectedItem(int selectionIndex) const

Returns the selected accessible item at index selectionIndex in the selection.

Note that the index refers to the n-th selected accessible item (i.e. the index in the current selection), which generally differs from the index that would be passed to QAccessibleInterface::child() in order to retrieve the same item.

The default implementation uses selectionIndex to retrieve the item from the list of selected items retrieved by QAccessibleSelectionInterface::selectedItems().

In particular for implementations dealing with many selected items, reimplementing this method in a more efficient way may be desirable for performance reasons.

[pure virtual] int QAccessibleSelectionInterface::selectedItemCount() const

Returns the total number of selected accessible items.

[pure virtual] QList<QAccessibleInterface *> QAccessibleSelectionInterface::selectedItems() const

Returns the list of selected accessible items.

[pure virtual] bool QAccessibleSelectionInterface::unselect(QAccessibleInterface *childItem)

Removes childItem from the selection.

Returns whether the accessible item has actually been removed from the selection.

© 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.