QML类型说明-Accessible

Accessible

ImportStatement:   import QtQuick2.2

 

Properties

checkStateMixed : bool

checkable : bool

checked : bool

defaultButton : bool

description : string

editable : bool

focusable : bool

focused : bool

multiLine : bool

name : string

passwordEdit : bool

pressed : bool

readOnly : bool

role : enumeration

selectable : bool

selectableText : bool

selected : bool

 

DetailedDescription

这个类是Accessibility的一部分。Accessibility是访问Qt QuickApplications（QtQuick应用程序）的元件。项目和用户交互，项目需要给用户信息，用户也需要传递信息给项目。辅助工具能让项目和用户以各种不同的方式交互。屏幕阅读器是这个类的QtQuick applications的实例。

这个类最重要的属性是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"

function accessiblePressAction() {

// do a button click

}

}

role指明了控制的类型是按钮。Accessible.name是最重要的信息，name是简短的描述，指明按钮显示的名称，和label的text内容连接。仅仅知道名字，还不能清晰的理解按钮是做什么的，所以description解释了控制的描述。函数accessiblePressAction()被辅助工具连接到按钮的触发上。这个函数需要有进入按钮范围和按钮按下的同样响应。

同时参阅文档Accessibility。

 

PropertyDocumentation

checkStateMixed : bool

这个属性保存元件是否是验证状态的一部分。默认为假，同时参阅checked和checkable。

 

checkable : bool

这个属性保存元件是否是可选的（像复选框和按钮）。默认为假，同时参阅checked。

 

checked : bool

这个属性保存元件是否正在验证。默认为假，同时参阅checkable。

 

defaultButton : bool

这个属性保存元件是否是对话框的默认按钮。默认为假。

 

description : string

设个属性设置了元件可访问的描述。和name属性相似。不过它更详细，并且告诉用户元件做什么的。例如按钮的功能描述。

 

editable : bool

这个属性描述了元件是否为可编辑的文本。默认为假。

 

focusable : bool

这个属性描述了元件是否支持焦点功能。除了元件是CheckBox、RadioButton、Button、MenuItem、PageTab、EditableText、SpinBox、ComboBox、Terminal或ScrollBar外，默认的情况下，这个属性为假。同时参阅focused。

 

focused : bool

这个属性反应了元件目前有焦点。默认为假，当QQuickItem::hasActiveFocus()返回真时，这个属性返回真值。同时参阅focusable。

 

multiLine : bool

这个属性反应了元件是否有多个文本行。默认为假。

 

name : string

这个属性是可访问的字符串。对一个按钮的实例，它绑定到按钮的text。一般这个属性设置成简单的人们可理解的名字。它只是名字的类型，不要包括你想控制的类型。

 

passwordEdit : bool

这个属性反应了元件是否是密码编辑文本。默认为假。

 

pressed : bool

这个属性反应了元件是否按下（例如按钮在鼠标按下期间）。默认为假。

 

readOnly : bool

这个属性反应了元件是否是只读的文本。这个属性和role是QAccessible::EditableText并设置只读属性相关。默认为假。

 

role : enumeration

这个属性指明了窗口的语义类型。例如一个按钮的语义类型是"Button"。它的值必定是QAccessible::Role中的一个。一些roles有特殊的语义。比如用"checked"属性在实现CheckBox的时候，必然需要。

Role	Properties and functions	Explanation
所有的互动元素	focusable focused	所有的元件都应该能与用户交互。当虚拟焦点在元件上时，focusable和focus设置为真。在诸如屏幕阅读器这样只支持触摸的设备上的应用，这很重要。它提供一个能从一个元件移动到另一个元件的虚拟焦点。
Button CheckBox RadioButton	accessiblePressAction()	一个按钮应该有一个名为accessiblePressAction()的函数。这个函数可以被诸如屏幕阅读器的辅助工具调用，当鼠标等设备发生点击等操作时响应。
CheckBox RadioButton	checkable checked	复选框的状态校验。更新了点击、校验和取消校验。
Slider SpinBox Dial ScrollBar	value minimumValue maximumValue stepSize	这些属性反映了元件的状态和可能的值。
Slider SpinBox Dial ScrollBar	accessibleIncreaseAction() accessibleDecreaseAction()	增加和减少元件的值。

 

selectable : bool

这个属性反应了元件是否是可选的。默认为假。同时参阅selected.

 

selectableText : bool

这个属性反应了元件是否包含可选的文字。默认为假

 

selected : bool

这个属性反应了元件是否被选中。默认为假。同时参阅selectable。