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.
- List of all members, including inherited members
- QAccessibleSelectionInterface is part of Accessibility Classes.
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.
© 2023 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.