State Struct

struct QAccessible::State

Public Functions


Public Variables

quint64 active
quint64 animated
quint64 busy
quint64 checkStateMixed
quint64 checkable
quint64 checked
quint64 collapsed
quint64 defaultButton
quint64 disabled
quint64 editable
quint64 expandable
quint64 expanded
quint64 extSelectable
quint64 focusable
quint64 focused
quint64 hasPopup
quint64 hotTracked
quint64 invalid
quint64 invisible
quint64 linked
quint64 marqueed
quint64 modal
quint64 movable
quint64 multiLine
quint64 multiSelectable
quint64 offscreen
quint64 passwordEdit
quint64 pressed
quint64 readOnly
quint64 searchEdit
quint64 selectable
quint64 selectableText
quint64 selected
quint64 selfVoicing
quint64 sizeable
quint64 supportsAutoCompletion
quint64 traversed
bool operator==(const State &first, const State &second)

Detailed Description

This structure defines bit flags that indicate the state of an accessible object. The values are:

activeThe object is the active window or the active sub-element in a container (that would get focus when focusing the container).
adjustableThe object represents an adjustable value, e.g. sliders.
animatedThe object's appearance changes frequently.
busyThe object cannot accept input at the moment.
checkableThe object is checkable.
checkedThe object's check box is checked.
checkStateMixedThe third state of checkboxes (half checked in tri-state check boxes).
collapsedThe object is collapsed, e.g. a closed listview item, or an iconified window.
defaultButtonThe object represents the default button in a dialog.
defunctThe object no longer exists.
editableThe object has a text carret (and often implements the text interface).
expandableThe object is expandable, mostly used for cells in a tree view.
expandedThe object is expanded, currently its children are visible.
extSelectableThe object supports extended selection.
focusableThe object can receive focus. Only objects in the active window can receive focus.
focusedThe object has keyboard focus.
hasPopupThe object opens a popup.
hotTrackedThe object's appearance is sensitive to the mouse cursor position.
invalidThe object is no longer valid (because it has been deleted).
invisibleThe object is not visible to the user.
linkedThe object is linked to another object, e.g. a hyperlink.
marqueedThe object displays scrolling contents, e.g. a log view.
modalThe object blocks input from other objects.
movableThe object can be moved.
multiLineThe object has multiple lines of text (word wrap), as opposed to a single line.
multiSelectableThe object supports multiple selected items.
offscreenThe object is clipped by the visible area. Objects that are off screen are also invisible.
passwordEditThe object is a password field, e.g. a line edit for entering a Password.
playsSoundThe object produces sound when interacted with.
pressedThe object is pressed.
readOnlyThe object can usually be edited, but is explicitly set to read-only.
searchEditThe object is a line edit that is the input for search queries.
selectableThe object is selectable.
selectableTextThe object has text which can be selected. This is different from selectable which refers to the object's children.
selectedThe object is selected, this is independent of text selection.
selfVoicingThe object describes itself through speech or sound.
sizeableThe object can be resized, e.g. top-level windows.
summaryElementThe object summarizes the state of the window and should be treated with priority.
supportsAutoCompletionThe object has auto-completion, for example in line edits or combo boxes.
traversedThe object is linked and has been visited.
updatesFrequentlyThe object changes frequently and needs to be refreshed when accessing it.
disabledThe object is unavailable to the user, e.g. a disabled widget.

Implementations of QAccessibleInterface::state() return a combination of these flags.

Member Function Documentation


Constructs a new QAccessible::State with all states set to false.

Member Variable Documentation

quint64 State::active

quint64 State::animated

quint64 State::busy

quint64 State::checkStateMixed

quint64 State::checkable

quint64 State::checked

quint64 State::collapsed

quint64 State::defaultButton

quint64 State::disabled

quint64 State::editable

quint64 State::expandable

quint64 State::expanded

quint64 State::extSelectable

quint64 State::focusable

quint64 State::focused

quint64 State::hasPopup

quint64 State::hotTracked

quint64 State::invalid

quint64 State::invisible

quint64 State::linked

quint64 State::marqueed

quint64 State::movable

quint64 State::multiLine

quint64 State::multiSelectable

quint64 State::offscreen

quint64 State::passwordEdit

quint64 State::pressed

quint64 State::readOnly

quint64 State::searchEdit

quint64 State::selectable

quint64 State::selectableText

quint64 State::selected

quint64 State::selfVoicing

quint64 State::sizeable

quint64 State::supportsAutoCompletion

quint64 State::traversed

Related Non-Members

bool operator==(const State &first, const State &second)

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