本页内容

QAccessible::State Struct

struct QAccessible::State

公共函数

State()

详细说明

该结构定义了指示可访问对象状态的位标志。其取值为:

常量描述
active该对象是活动窗口,或容器中的活动子元素(当容器获得焦点时,该子元素也会获得焦点)。
adjustable该对象表示一个可调整的值,例如滑块。
animated该对象的外观会频繁变化。
busy该对象目前无法接受输入。
checkable该对象可被选中。
checked该对象的复选框已被选中。
checkStateMixed复选框的第三种状态(三态复选框中的半选中状态)。
collapsed该对象处于折叠状态,例如:已关闭的列表视图项目或已最小化的窗口。
defaultButton该对象代表对话框中的默认按钮。
defunct该对象已不存在。
editable该对象具有文本光标(并且通常实现了文本接口)。
expandable该对象可展开,主要用于树视图中的单元格。
expanded该对象处于展开状态,当前其子项可见。
extSelectable该对象支持扩展选择。
focusable该对象可以获得焦点。只有活动窗口中的对象才能获得焦点。
focused该对象具有键盘焦点。
hasPopup该对象会打开一个弹出窗口。
hotTracked该对象的外观会对鼠标光标的位置产生反应。
invalid该对象已不再有效(因为已被删除)。
invisible用户无法看到该对象。
linked该对象与另一个对象相关联,例如超链接。
marqueed该对象显示可滚动的内容,例如日志视图。
modal该对象会阻止来自其他对象的输入。
movable该对象可以移动。
multiLine该对象包含多行文本(自动换行),而非单行文本。
multiSelectable该对象支持多选。
offscreen该对象被可见区域裁剪。位于屏幕外的对象也是不可见的。
passwordEdit该对象是一个密码字段,例如用于输入密码的行编辑框。
playsSound与该对象交互时会发出声音。
pressed该对象被按下。
readOnly该对象通常可以编辑,但被显式设置为只读。
searchEdit该对象是一个用于输入搜索查询的行编辑框。
selectable该对象可被选中。
selectableText该对象包含可选中的文本。这与“可选中”不同,后者指的是对象的子元素。
selected该对象已被选中,这与文本选择无关。
selfVoicing该对象通过语音或声音描述自身。
sizeable该对象可以调整大小,例如顶级窗口。
summaryElement该对象概括了窗口的状态,应优先处理。
supportsAutoCompletion该对象具有自动完成功能,例如行编辑框或组合框。
traversed该对象是链接,且已被访问过。
updatesFrequently该对象变化频繁,在访问时需要刷新。
disabled该对象对用户不可用,例如被禁用的控件。

QAccessibleInterface::state() 的实现会返回这些标志的组合。

成员函数文档

State::State()

创建一个新的QAccessible::State ,并将所有状态均设置为false。

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