Accessible QML Type (Uncreatable)

QMLアイテムのアクセシビリティを有効にします。詳細...

Import Statement: import QtQuick

注：これは生成不可能な型です。QML 内でインスタンス化することはできません。

継承されたメンバーを含む、すべてのメンバーの一覧
Accessibleは、アクセシビリティクラスの一部です。

プロパティ

checkStateMixed : bool
checkable : bool
checked : bool
defaultButton : bool
description : string
editable : bool
expandable : bool (since 6.12)
expanded : bool (since 6.12)
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

信号

方法

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 は最も重要な情報であり、ボタンのテキストに紐付けられています。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 です。

expandable : bool `[since 6.12]`

このプロパティは、この項目が展開可能かどうかを示します。

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

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

「expanded」も参照してください。

expanded : bool `[since 6.12]`

このプロパティは、この項目が現在展開されているかどうかを表します。

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

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

「expandable」も参照してください。

focusable : bool

このプロパティは、このアイテムにフォーカスを合わせられるかどうかを示します。

デフォルトでは、このプロパティの値は `false ` ですが、role が `CheckBox`、`RadioButton`、`Switch`、`Button`、`MenuItem`、`PageTab`、`EditableText`、`SpinBox`、`ComboBox`、`Terminal `、または `ScrollBar` のいずれかである項目は例外となります。

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」プロパティが期待されます。

ロール	プロパティとシグナル	説明
すべてのインタラクティブ要素	focusable およびfocused	ユーザーが操作可能なすべての要素は、`focusable` を ``true` ` に設定し、フォーカスが当たっているときは ``focus` ` を ``true` ` に設定する必要があります。スクリーンリーダーは、多くの場合、項目から項目へと移動できる仮想フォーカスを実装しているため、これはタッチ操作のみのデバイスで動作するアプリケーションにおいても重要です。
ボタン、CheckBox 、RadioButton 、スイッチ	Accessible.pressAction	ボタンには、`onPressAction` という名前のシグナルハンドラを設定する必要があります。このシグナルは、スクリーンリーダーなどの支援ツールによって発せられる場合があります。実装では、ボタンへのマウスクリックやタップと同じ動作を行う必要があります。
CheckBox、RadioButton 、Switch	checkable,checked,Accessible.toggleAction	チェックボックスのチェック状態。Press、Check、Uncheckアクション時に更新されます。
スライダー、SpinBox 、ダイヤル、ScrollBar	`value`,`minimumValue`,`maximumValue`,`stepSize`	これらのプロパティは、各要素の状態および取り得る値を反映します。
スライダー、SpinBox 、ダイヤル、ScrollBar	Accessible.increaseAction,Accessible.decreaseAction	要素の値を増減させる操作。

searchEdit : bool

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

デフォルトでは、このプロパティはfalse に設定されています。

selectable : bool

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

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

「selected」も参照してください。

selectableText : bool

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

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

selected : bool

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

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

「selectable」も参照してください。

Signal ドキュメント

decreaseAction()

このシグナルは、スクリーンリーダーなどの支援ツールから「縮小」操作の指示を受け取った際に発信されます。

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

increaseAction()

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

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

nextPageAction()

このシグナルは、スクリーンリーダーなどの支援ツールから「次のページ」操作の指示を受け取った際に発せられます。

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

pressAction()

このシグナルは、スクリーンリーダーなどの支援ツールから押下操作の信号を受信した際に発せられます。

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

previousPageAction()

このシグナルは、スクリーンリーダーなどの支援ツールから、前のページへの操作が受信されたときに発信されます。

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

scrollDownAction()

このシグナルは、スクリーンリーダーなどの支援ツールからスクロールダウン操作が受信されたときに発せられます。

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

scrollLeftAction()

このシグナルは、スクリーンリーダーなどの支援ツールから左スクロール操作が受信されたときに発せられます。

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

scrollRightAction()

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

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

scrollUpAction()

このシグナルは、スクリーンリーダーなどの支援ツールからスクロールアップ操作が受信されたときに発せられます。

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

showOnScreenAction()

このシグナルは、スクリーンリーダーなどの支援ツールが、部分的に表示されている要素を検出し、その要素を完全に表示するよう要求した際に発せられます。

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

toggleAction()

このシグナルは、スクリーンリーダーなどの支援ツールからトグル操作が受信された際に発せられます。

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

メソッドのドキュメント

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

politeness の礼儀レベルを指定したmessage を含むアナウンスイベントを発行します。

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

QAccessibleAnnouncementEventも参照してください。

© 2026 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 (Uncreatable)

プロパティ

信号

方法

詳細説明

プロパティのドキュメント

checkStateMixed : bool

checkable : bool

checked : bool

defaultButton : bool

description : string

editable : bool

expandable : bool [since 6.12]

expanded : bool [since 6.12]

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

Signal ドキュメント

decreaseAction()

increaseAction()

nextPageAction()

pressAction()

previousPageAction()

scrollDownAction()

scrollLeftAction()

scrollRightAction()

scrollUpAction()

showOnScreenAction()

toggleAction()

メソッドのドキュメント

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

expandable : bool `[since 6.12]`

expanded : bool `[since 6.12]`

labelFor : Item `[since 6.10]`

labelledBy : Item `[since 6.10]`

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