Accessible QML Type

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

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

プロパティ

• checkStateMixed : bool
• checkable : bool
• checked : bool
• defaultButton : bool
• description : string
• editable : bool
• focusable : bool
• focused : bool
• id : string
• ignored : bool
• labelFor : Item (since 6.10)
• labelledBy : Item (since 6.10)
• multiLine : bool
• name : string
• passwordEdit : bool
• pressed : bool
• readOnly : bool
• role : enumeration
• searchEdit : bool
• selectable : bool
• selectableText : bool
• selected : bool

信号

• decreaseAction()
• increaseAction()
• nextPageAction()
• pressAction()
• previousPageAction()
• scrollDownAction()
• scrollLeftAction()
• scrollRightAction()
• scrollUpAction()
• toggleAction()

方法

• void announce(string message, AnnouncementPoliteness politeness) (since 6.8)

詳細説明

このクラスは 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
    }
}

role はButton に設定され、コントロールのタイプを示します。name は最も重要な情報で、ボタン上のテキストにバインドされます。名前はコントロールの簡潔な説明で、視覚的なラベルを反映する必要があります。この場合、名前だけではボタンが何をするのかわからないので、description 。また、アシストツールがボタンを起動するためのシグナルハンドラ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

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

デフォルトでは、ロールがCheckBox,RadioButton,Switch,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 です。

labelFor : Item [since 6.10]

このプロパティは、このアイテムがラベルとなるアイテムを保持する。

このプロパティを設定すると、もう一方のオブジェクトのlabelledBy リレーションが自動的に設定される。

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

このプロパティは Qt 6.10 で導入されました。

labelledBy : Item [since 6.10]

このプロパティは、このアイテムのラベルとして使用されるアイテムを保持する。

このプロパティを設定すると、もう一方のオブジェクトのlabelFor リレーションが自動的に設定される。

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

このプロパティは Qt 6.10 で導入されました。

multiLine : bool

このプロパティは、このアイテムが複数のテキスト行を持つかどうかを保持する。

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

name : string

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

passwordEdit : bool

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

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

pressed : bool

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

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

readOnly : bool

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

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

role : enumeration

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

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

searchEdit : bool

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

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

selectable : bool

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

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

selectedも参照してください 。

selectableText : bool

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

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

selected : bool

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

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

selectableも参照してください 。

シグナルのドキュメント

decreaseAction()

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

increaseAction()

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

nextPageAction()

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

pressAction()

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

previousPageAction()

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

scrollDownAction()

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

scrollLeftAction()

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

scrollRightAction()

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

scrollUpAction()

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

toggleAction()

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

メソッドのドキュメント

[since 6.8] void announce(string message, AnnouncementPoliteness politeness)

message politeness でアナウンスイベントを発行します。

このメソッドは Qt 6.8 で導入されました。

QAccessibleAnnouncementEventも参照してください 。