可访问 QML 类型

启用 QML 项的访问性。更多信息...

导入语句	import QtQuick

所有成员列表，包括继承成员
Accessible 是可访问性类的一部分。

属性

checkStateMixed : bool
checkable : bool
checked : bool
defaultButton : bool
description : string
editable : bool
focusable : bool
focused : bool
ignored : bool
multiLine : bool
name : string
passwordEdit : bool
pressed : bool
readOnly : bool
role : enumeration
searchEdit : bool
selectable : bool
selectableText : bool
selected : bool

信号

详细描述

此类是 Qt Quick 应用可访问性的一部分。

用户与之交互或向用户提供信息的项需要将其信息暴露给可访问性框架。然后辅助工具可以利用这些信息以各种方式使用户能够与应用程序进行交互。这使得 Qt Quick 应用程序可以与屏幕阅读器一起使用，例如。

最重要的属性是 name、description 和 role。

简单按钮的示例实现

Rectangle {
    id: myButton
    Text {
        id: label
        text: "next"
    }
    Accessible.role: Accessible.Button
    Accessible.name: label.text
    Accessible.description: "shows the next page"
    Accessible.onPressAction: {
        // do a button click
    }
}

将角色设置为 按钮 以指示控件类型。名称是最重要的信息，并绑定到按钮上的文本。该名称是对控件的简要描述，应反映可视标签。在这种情况下，仅凭名称无法清楚知道按钮的作用，因此描述包含了一个说明。还有一个信号处理器 Accessible.pressAction，辅助工具可以调用它以触发按钮。这个信号处理器需要有与点击按钮相同的效果。

请参阅辅助功能.

属性文档

checkStateMixed : bool

该属性指示此项目是否处于部分选中状态。

默认情况下，此属性为 false。

请参阅checked 和 checkable.

checkable : bool

该属性指示此控件是否可以选中（如复选框或某些按钮）。

默认情况下，此属性为 false。

请参阅checked.

checked : bool

该属性指示此项是否当前处于选中状态。

默认情况下，此属性为 false。

请参阅checkable.

defaultButton : bool

该属性指示此控件是否是对话框的默认按钮。

默认情况下，此属性为 false。

description : string

该属性设置可访问性描述。类似于名称，它描述项目。描述可以更详细，并说明项目的作用，例如所描述按钮的功能。

editable : bool

该属性指示此项目是否具有可编辑文本。

默认情况下，此属性为 false。

focusable : bool

该属性指示此项目是否可聚焦。

默认情况下，此属性为 false，除非控件的其中一个角色是 CheckBox、RadioButton、Button、MenuItem、PageTab、EditableText、SpinBox、ComboBox、Terminal 或 ScrollBar。

请参阅focused.

focused : bool

该属性指示此项目当前是否有活动焦点。

默认情况下，此属性为 false，但如果有 QQuickItem::hasActiveFocus() 返回 true 的项目，该属性将返回 true。

请参阅focusable.

ignored : bool

该属性指示此项目是否应被辅助功能框架忽略。

有时候一个项目是若干项目组的一部分，这些项目应视为一个整体。例如，两个标签可能视觉上并排放置，但彼此分离。为了辅助功能的目的，它们应被视为一个整体，因此它们由一个具有正确几何形状的第三个不可见项目表示。

例如，一个速度显示将 "m/s" 作为一个小标签添加

Row {
    Label {
        id: speedLabel
        text: "Speed: 5"
        Accessible.ignored: true
    }
    Label {
        text: qsTr("m/s")
        Accessible.ignored: true
    }
    Accessible.role: Accessible.StaticText
    Accessible.name: speedLabel.text + " meters per second"
}

默认情况下，此属性为 false。

multiLine : bool

该属性指示此项目是否具有多行文本。

默认情况下，此属性为 false。

名称 : 字符串

此属性设置了一个可访问的名称。例如，对于按钮，这应该与其文本绑定。一般来说，此属性应设置为简单、简洁但易读的名称。不要包括您想要表示的控件类型，只需名称即可。

passwordEdit : 布尔值

此属性保存项目是否为密码文本编辑器。

默认情况下，此属性为 false。

pressed : 布尔值

此属性保存项目是否被按下（例如鼠标点击时的按钮）。

默认情况下，此属性为 false。

readOnly : 布尔值

此属性表示文本字段是否为只读。

当角色是《QAccessible::EditableText》并且设置为只读时，这才有意义。默认情况下，此属性为false。

role : 枚举

此标志设置小部件的语义类型。例如，按钮的类型将是“按钮”。值必须是《QAccessible::Role》之一。

某些角色具有特殊的语义。例如，为了实现复选框，期望有“已检查”属性。

角色	属性和信号	说明
所有交互式元素	focusable 和 focused	所有用户可以与之交互的元素应当将focusable设置为`true`，并在它们获得焦点时将`focus`设置为`true`。这对于仅在触摸设备上运行的应用程序尤其重要，因为屏幕阅读器通常会实现一个虚拟焦点，可以从项目移动到另一个项目。
按钮，复选框，单选按钮	Accessible.pressAction	按钮应有一个名为`onPressAction`的信号处理器。此信号可能由辅助工具（如屏幕阅读器）发出。实现需要与鼠标点击或按钮上的轻触相同的操作。
复选框，单选按钮	checkable，checked，Accessible.toggleAction	复选框的状态。在按下、选中和不选中操作时更新。
滑块，数字输入框，旋钮，滚动条	`value`，`minimumValue`，`maximumValue`，`stepSize`	这些属性反映了元素的状态和可能值。
滑块，数字输入框，旋钮，滚动条	Accessible.increaseAction，Accessible.decreaseAction	增加和减少元素值的操作。

searchEdit : 布尔值

此属性保存该项目是否为搜索查询的输入。此属性将仅影响可编辑文本。

默认情况下，此属性为 false。

selectable : 布尔值

此属性保存项目是否可被选择。

默认情况下，此属性为 false。

另请参阅 selected.

selectableText : 布尔值

此属性保存此项目是否包含可选择的文本。

默认情况下，此属性为 false。

selected : bool

此属性表示此项目是否被选中。

默认情况下，此属性为 false。

另请参阅：selectable.

信号文档

decreaseAction()

当接收到来自辅助工具（如屏幕阅读器）的减小动作时，将发出此信号。

注意：对应的处理函数是 onDecreaseAction。

increaseAction()

当接收到来自辅助工具（如屏幕阅读器）的增大动作时，将发出此信号。

注意：对应的处理函数是 onIncreaseAction。

nextPageAction()

当接收到来自辅助工具（如屏幕阅读器）的下页动作时，将发出此信号。

注意：对应的处理函数是 onNextPageAction。

pressAction()

当接收到来自辅助工具（如屏幕阅读器）的按键动作时，将发出此信号。

注意：对应的处理函数是 onPressAction。

previousPageAction()

当接收到来自辅助工具（如屏幕阅读器）的上页动作时，将发出此信号。

注意：对应的处理函数是 onPreviousPageAction。

scrollDownAction()

当接收到来自辅助工具（如屏幕阅读器）的向下滚动动作时，将发出此信号。

注意：对应的处理函数是 onScrollDownAction。

scrollLeftAction()

当接收到来自辅助工具（如屏幕阅读器）的向左滚动动作时，将发出此信号。

注意：对应的处理函数是 onScrollLeftAction。

scrollRightAction()

当接收到来自辅助工具（如屏幕阅读器）的向右滚动动作时，将发出此信号。

注意：对应的处理函数是 onScrollRightAction。

scrollUpAction()

当接收到来自辅助工具（如屏幕阅读器）的向上滚动动作时，将发出此信号。

注意：对应的处理函数是 onScrollUpAction。

toggleAction()

当接收到来自辅助工具（如屏幕阅读器）的切换动作时，将发出此信号。

注意：对应的处理函数是 onToggleAction。