Accessible QML Type

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

Import Statement: import QtQuick

継承メンバを含む全メンバ一覧
Accessible はアクセシビリティクラスの一部です。

プロパティ

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

信号

詳細説明

ユーザーが相互作用するアイテム、またはユーザーに情報を与えるアイテムは、それらの情報をアクセシビリティ・フレームワークに公開する必要があります。そうすれば、支援ツールはその情報を利用して、ユーザーがさまざまな方法でアプリケーションと対話できるようにすることができます。これにより、例えば、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 、RadioButton	Accessible.pressAction	ボタンは、`onPressAction` という名前のシグナル・ハンドラを持つべきです。このシグナルは、スクリーン・リーダーのような支援ツールによって発せられるかもしれません。実装では、ボタンをマウスでクリックしたりタップしたりしたときと同じ動作をする必要があります。
CheckBox,RadioButton	checkable checked 、Accessible.toggleAction	チェックボックスのチェック状態。Press、Check、Uncheckアクションで更新。
スライダー,SpinBox, ダイヤル、ScrollBar	`value`,`minimumValue`,`maximumValue` 、`stepSize`	これらのプロパティは、要素の状態と可能な値を反映します。
Slider,SpinBox, Dial、ScrollBar	Accessible.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 です。

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

Accessible QML Type

プロパティ

信号

詳細説明

プロパティ Documentation

シグナル ドキュメント

シグナルドキュメント