Back to Qt.io
Contact Us Blog Download Qt

Accessible QML Type

QML アイテムにアクセスできるようにする。詳細...

Import Statement: import QtQuick

プロパティ

シグナル

詳細説明

このクラスは、Accessibility for Qt Quick Applications の一部です。

ユーザーが操作するアイテムやユーザーに情報を与えるアイテムは、アクセシビリティ・フレームワークに情報を公開する必要があります。そうすれば、支援ツールはその情報を利用して、ユーザが様々な方法でアプリケーションと対話できるようにすることができます。これにより、例えば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
    }
}

role はButton に設定され、コントロールのタイプを示します。name は最も重要な情報で、ボタン上のテキストにバインドされます。名前はコントロールの短く簡潔な説明で、視覚的なラベルを反映する必要があります。この場合、名前だけではボタンが何をするのかわからないので、description 。また、アシストツールがボタンを起動するためのシグナルハンドラAccessible.pressAction 。このシグナルハンドラは、ボタンをタップしたりクリックしたりするのと同じ効果を持つ必要があります。

アクセシビリティも参照してください 。

プロパティ Documentation

checkStateMixed : bool

このプロパティは、このアイテムが部分的にチェックされた状態にあるかどうかを保持する。

デフォルトでは、このプロパティはfalse です。

checked およびcheckableも参照して ください。


checkable : bool

このプロパティは、このアイテムがチェック可能かどうかを保持します（チェックボックスやいくつかのボタンのように）。

デフォルトでは、このプロパティはfalse です。

checkedも参照して ください。


checked : bool

このプロパティは、この項目が現在チェックされているかどうかを保持します。

デフォルトでは、このプロパティはfalse です。

checkableも参照して ください。


defaultButton : bool

このプロパティは、この項目がダイアログのデフォルトボタンであるかどうかを保持します。

デフォルトでは、このプロパティはfalse です。


description : string

このプロパティは、アクセス可能な説明を設定します。名前と同様に、項目を説明します。説明はもう少し冗長にすることができ、そのアイテムが何をするのか、例えば説明しているボタンの機能などを伝えることができます。


editable : bool

このプロパティは、このアイテムに編集可能なテキストがあるかどうかを保持します。

デフォルトでは、このプロパティはfalse です。


focusable : bool

このプロパティは、このアイテムがフォーカス可能かどうかを保持する。

デフォルトでは、ロールがCheckBox,RadioButton,Button,MenuItem,PageTab,EditableText,SpinBox,ComboBox,Terminal またはScrollBar のいずれかであるアイテムを除き、このプロパティはfalse です。

focusedも参照 。


focused : bool

このプロパティは、このアイテムが現在アクティブフォーカスを持つかどうかを保持する。

デフォルトでは、このプロパティはfalse ですが、QQuickItem::hasActiveFocus() がtrue を返しているアイテムの場合はtrue を返します。

focusableも参照 。


id : string

このプロパティは、オブジェクトの識別子を設定します。UI テストに安定した識別子を提供するために使用できます。デフォルトでは、識別子は QML オブジェクトの ID に設定されます。ID が設定されていない場合は、デフォルトのQAccessible::Identifier が使用されます。


ignored : bool

このプロパティは、このアイテムがアクセシビリティフレームワークによって無視されるべきかどうかを保持します。

ある項目が、1つの項目として扱われるべきグループの一部であることがあります。例えば、2つのラベルが視覚的には隣同士に配置されていても、別々のアイテムである場合があります。アクセシビリティの目的のために、それらは1つとして扱われるべきであり、したがって、それらは正しいジオメトリを持つ3番目の不可視のアイテムによって表現されます。

例えば、速度表示は、小さいラベルとして "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 です。


name : string

このプロパティは、アクセス可能な名前を設定します。例えばボタンの場合、これはそのテキストにバインディングを持つ必要があります。一般的に、このプロパティには、シンプルで簡潔な、しかし人間が読みやすい名前を設定する必要があります。表現したいコントロールのタイプは含めず、名前だけを設定する。


passwordEdit : bool

このプロパティは、このアイテムがパスワードテキスト編集であるかどうかを保持する。

デフォルトでは、このプロパティはfalse です。


pressed : bool

このプロパティは、この項目が押されているかどうかを保持します（例えば、マウスクリック時のボタン）。

デフォルトでは、このプロパティはfalse です。


readOnly : bool

このプロパティは、テキスト・フィールドが読み取り専用であることを示します。

ロールがQAccessible::EditableText で、読み取り専用に設定されている場合に関連します。デフォルトでは、このプロパティはfalse です。


role : enumeration

このフラグは、ウィジェットのセマンティックタイプを設定します。例えばボタンはタイプとして "Button "を持つ。値はQAccessible::Role のいずれかでなければならない。

いくつかのロールは特別なセマンティクスを持ちます。例えばチェックボックスを実装するには、"checked "プロパティが必要です。

役割プロパティとシグナル説明
すべてのインタラクティブ要素focusable そしてfocusedユーザが対話できるすべての要素は、focusable をtrue に設定し、フォーカスがあるときはfocus をtrue に設定する必要があります。スクリーン・リーダーは、アイテムからアイテムへ移動できる仮想フォーカスを実装していることが多いため、これはタッチ専用デバイスで動作するアプリケーションでも重要です。
ボタン、CheckBox 、RadioButtonAccessible.pressActionボタンは、onPressAction という名前のシグナル・ハンドラを持つべきです。このシグナルは、スクリーン・リーダーのような支援ツールによって発せられるかもしれません。実装では、ボタンをマウスでクリックしたりタップしたりしたときと同じ動作をする必要があります。
CheckBox,RadioButtoncheckable checked 、Accessible.toggleActionチェックボックスのチェック状態。Press、Check、Uncheckアクションで更新。
スライダー,SpinBox, ダイヤル、ScrollBarvalue,minimumValue,maximumValue 、stepSizeこれらのプロパティは、要素の状態と可能な値を反映します。
Slider,SpinBox, Dial、ScrollBarAccessible.increaseAction,Accessible.decreaseAction要素の値を増減するアクション。

searchEdit : bool

このプロパティは、この項目が検索クエリの入力であるかどうかを保持します。このプロパティは、編集可能なテキストにのみ影響します。

デフォルトでは、このプロパティはfalse です。


selectable : bool

このプロパティは、この項目が選択可能かどうかを保持します。

デフォルトでは、このプロパティはfalse です。

selectedも参照してください 。


selectableText : bool

このプロパティは、このアイテムに選択可能なテキストが含まれているかどうかを保持します。

デフォルトでは、このプロパティはfalse です。


selected : bool

このプロパティは、この項目が選択されているかどうかを保持する。

デフォルトでは、このプロパティはfalse です。

selectableも参照して ください。


シグナル ドキュメント

decreaseAction()

このシグナルは、スクリーンリーダーなどの支援ツールから減少アクションを受信したときに発行されます。

注意： 対応するハンドラはonDecreaseAction です。


increaseAction()

このシグナルは、スクリーンリーダーなどの支援ツールから増加アクションを受け取ったときに発せられます。

注： 対応するハンドラはonIncreaseAction です。


nextPageAction()

このシグナルは、スクリーンリーダーなどの支援ツールからnext pageアクションを受け取ったときに発せられる。

注： 対応するハンドラはonNextPageAction です。


pressAction()

このシグナルは、スクリーンリーダーなどの支援ツールからプレスアクションを受信したときに発せられます。

注： 対応するハンドラはonPressAction です。


previousPageAction()

このシグナルは、スクリーンリーダーなどの支援ツールから前ページアクションを受信したときに出力されます。

注： 対応するハンドラはonPreviousPageAction です。


scrollDownAction()

このシグナルは、スクリーン・リーダーなどの支援ツールからスクロール・ダウン・アクションを受け取ったときに発せられます。

注： 対応するハンドラはonScrollDownAction です。


scrollLeftAction()

このシグナルは、スクリーンリーダーなどの支援ツールから左スクロールアクションを受け取ったときに発せられます。

注： 対応するハンドラはonScrollLeftAction です。


scrollRightAction()

このシグナルは、スクリーンリーダーなどの支援ツールから右スクロールアクションを受け取ったときに発せられます。

注： 対応するハンドラはonScrollRightAction です。


scrollUpAction()

このシグナルは、スクリーンリーダーなどの支援ツールからスクロールアップアクションを受け取ったときに発せられます。

注： 対応するハンドラはonScrollUpAction です。


toggleAction()

このシグナルは、スクリーンリーダーなどの支援ツールからトグルアクションを受け取ったときに発せられます。

注: 対応するハンドラはonToggleAction です。


本書に含まれる文書の著作権は、それぞれの所有者に帰属します。 本書で提供されるドキュメントは、Free Software Foundation が発行したGNU Free Documentation License version 1.3に基づいてライセンスされています。 Qtおよびそれぞれのロゴは、フィンランドおよびその他の国におけるThe Qt Company Ltd.の 商標です。その他すべての商標は、それぞれの所有者に帰属します。