QAccessible Class
QAccessible クラスは、アクセシビリティに関連する列挙型と静的関数を提供します。詳細...
| Header: | #include <QAccessible> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS Gui)target_link_libraries(mytarget PRIVATE Qt6::Gui) |
| qmake: | QT += gui |
- 継承メンバを含む全メンバ一覧
- QAccessible はアクセシビリティ・クラスの一部です。
パブリック・タイプ
| struct | State |
(since 6.8) enum class | AnnouncementPoliteness { Polite, Assertive } |
(since 6.8) enum class | Attribute { Custom, Level } |
| enum | Event { AcceleratorChanged, ActionChanged, ActiveDescendantChanged, Alert, Announcement, …, VisibleDataChanged } |
| Id | |
| InterfaceFactory | |
| enum | InterfaceType { TextInterface, ValueInterface, ActionInterface, TableInterface, TableCellInterface, …, AttributesInterface } |
| flags | Relation |
| enum | RelationFlag { Label, Labelled, Controller, Controlled, DescriptionFor, …, AllRelations } |
| enum | Role { AlertMessage, Animation, Application, Assistant, Border, …, Window } |
| enum | Text { Name, Description, Value, Help, Accelerator, …, Identifier } |
| enum | TextBoundaryType { CharBoundary, WordBoundary, SentenceBoundary, ParagraphBoundary, LineBoundary, NoBoundary } |
静的パブリック・メンバー
| QAccessibleInterface * | accessibleInterface(QAccessible::Id id) |
| void | deleteAccessibleInterface(QAccessible::Id id) |
| void | installFactory(QAccessible::InterfaceFactory factory) |
| bool | isActive() |
| QAccessibleInterface * | queryAccessibleInterface(QObject *object) |
| QAccessible::Id | registerAccessibleInterface(QAccessibleInterface *iface) |
| void | removeFactory(QAccessible::InterfaceFactory factory) |
| void | setRootObject(QObject *object) |
| QAccessible::Id | uniqueId(QAccessibleInterface *iface) |
| void | updateAccessibility(QAccessibleEvent *event) |
詳細説明
このクラスは、QWidgetアプリケーションのアクセシビリティの一部です。
アクセシブル・アプリケーションは、従来の方法ではアプリケーションを使用することができない人々によって使用されます。
このクラスの関数は、アクセシブル・アプリケーション（ATサーバとも呼ばれる）と、スクリーン・リーダーや点字ディスプレイなどのアクセシビリティ・ツール（ATクライアント）との間の通信に使用されます。クライアントとサーバーは次のように通信する：
- ATサーバーは、updateAccessibility （）関数の呼び出しを通じて、クライアントに対してイベントを通知する。
- ATクライアントは、サーバー内のオブジェクトに関する情報を要求する。QAccessibleInterface クラスはコア・インターフェースであり、この情報を純粋な仮想APIにカプセル化する。このインターフェースの実装は、queryAccessibleInterface() APIを通してQtによって提供されます。
サーバーとクライアント間の通信はsetRootObject() 関数によって初期化されます。関数ポインタをインストールすることで、QAccessible の静的関数のデフォルトの動作を置き換えたり、拡張したりすることができます。
QtはMicrosoft Active Accessibility (MSAA)、macOS Accessibility、Unix/X11 AT-SPI標準をサポートしています。その他のバックエンドはQAccessibleBridgeを使用してサポートできます。
Unix/X11 AT-SPIの実装では、2つの条件が満たされたときにアプリケーションがアクセシブルになります：
- org.a11y.Status.IsEnabledDBusプロパティがtrueである。
- org.a11y.Status.ScreenReaderEnabledDBusプロパティがtrueである。
DBus AT-SPIプロパティを設定する代わりに、QT_LINUX_ACCESSIBILITY_ALWAYS_ON環境変数を設定することもできます。
QAccessibleの静的関数に加えて、Qtは、すべてのウィジェットやオブジェクトをラップするために使用できる1つの汎用インタフェース、QAccessibleInterface を提供します（例えば、QPushButton ）。この単一のインターフェイスは、支援技術に必要なすべてのメタデータを提供します。Qt は、このインターフェースの実装をプラグインとして内蔵ウィジェットに提供しています。
カスタムウィジェットを開発する場合、QAccessibleInterface のカスタムサブクラスを作成し、プラグインとして配布するか（QAccessiblePlugin を使用）、アプリケーションにコンパイルします。同様に、Qtの定義済みアクセシビリティサポートは、プラグイン（デフォルト）として、またはQtライブラリに直接組み込むことができます。プラグインを使用する主な利点は、アクセシビリティクラスが実際に使用される場合にのみメモリにロードされることです。
Qt には、QAccessibleInterface を継承し、最小公倍数のメタデータ（ウィジェットのジオメトリ、ウィンドウのタイトル、基本的なヘルプテキストなど）を提供する 2 つの便利なクラス、QAccessibleObject とQAccessibleWidget もあります。カスタムのQObject やQWidget サブクラスをラップするときに、基本クラスとして使用することができます。
QAccessibleInterfaceも参照してください 。
メンバ型ドキュメント
[since 6.8] enum class QAccessible::AnnouncementPoliteness
この列挙型は、QAccessibleAnnouncementEvent で使用されるアナウンスの優先順位を記述します。
QAccessible::AnouncementPoliteness::Polite を指定すると、支援技術は、現在の文の話し終わりや、ユーザが入力を一時停止したときなど、次の猶予のある機会にメッセージをアナウンスする必要があります。
QAccessible::AnouncementPoliteness::Assertive を指定する場合、支援技術は直ちにユーザーに通知すべきである。
中断は、ユーザを混乱させたり、現在のタスクを完了させない原因となる可能性があるため、QAccessible::AnouncementPoliteness::Assertive 、中断が緊急でない限り使用すべきではありません。
| 定数 | 値 | 説明 |
|---|---|---|
QAccessible::AnnouncementPoliteness::Polite | 0 | アナウンスは通常の優先度を持つ。 |
QAccessible::AnnouncementPoliteness::Assertive | 1 | アナウンスは高い優先度を持ち、ユーザーの現在のタスクを中断することを意味しても、すぐにユーザーに通知する必要があります。 |
この列挙型は Qt 6.8 で導入されました。
QAccessibleAnnouncementEventも参照して ください。
[since 6.8] enum class QAccessible::Attribute
この列挙型は、QAccessibleAttributesInterface によって使用されるさまざまなタイプの属性を記述します。
これらの属性は、ARIA、AT-SPI2、IAccessible、UIA、NSAccessibilityで見られるプロパティ/（オブジェクト）属性の概念に匹敵し、該当する場合、それらのプラットフォーム対応にマッピングされています。
各属性は、キーと値のペアとして扱われ、この列挙の値がキーとして使われます。
属性値はQVariant で表現されます。QVariant に格納される値の型は固定で、属性タイプごとに以下で指定されます。
| 定数 | 値 | 説明 |
|---|---|---|
QAccessible::Attribute::Custom | 0 | 値の型：QHash<QString QString>Custom 属性は、それ自身がキーと値のペアを表現するために使われるQHash であるため、一度に複数の属性を効果的に表現できるという点で特別です。属性のためのカスタムキーと値のペアをサポートするプラットフォームでは、Custom 属性で設定されたものは、プラットフォーム固有の属性への変換を適用することなく、プラットフォーム層にブリッジされます。一般的には、より強く型付けされた他の属性が使用されるべきです。この属性は、例えば、特定の機能に対して公式に新しい列挙値を追加する前に、プロトタイピングのために使用することができます。 |
QAccessible::Attribute::Level | 1 | 値の型： int 構造内の要素の階層レベル、例えば見出しの見出しレベルを定義します。この属性は、ARIAの "aria-level "プロパティと概念的に一致します。 |
この列挙型は Qt 6.8 で導入されました。
QAccessibleAttributesInterfaceも参照してください 。
enum QAccessible::Event
この列挙型は、アクセス可能なイベントタイプを定義します。
| 定数 | 値 | 説明 |
|---|---|---|
QAccessible::AcceleratorChanged | 0x80C0 | アクションのキーボードアクセラレータが変更されました。 |
QAccessible::ActionChanged | 0x0101 | アクションが変更された。 |
QAccessible::ActiveDescendantChanged | 0x0102 | |
QAccessible::Alert | 0x0002 | システムアラート(例えば、QMessageBox からのメッセージ) |
QAccessible::Announcement (since Qt 6.8) | 0x80D0 | メッセージのアナウンスが要求されました。 |
QAccessible::AttributeChanged | 0x0103 | |
QAccessible::ContextHelpEnd | 0x000D | オブジェクトのコンテキストヘルプ (QWhatsThis) が終了しました。 |
QAccessible::ContextHelpStart | 0x000C | オブジェクトのコンテキスト・ヘルプ (QWhatsThis) が開始されました。 |
QAccessible::DefaultActionChanged | 0x80B0 | アクセス可能なオブジェクトのデフォルトの QAccessible::Action が変更されました。 |
QAccessible::DescriptionChanged | 0x800D | オブジェクトのQAccessible::Description が変更されました。 |
QAccessible::DialogEnd | 0x0011 | ダイアログ (QDialog) が非表示になりました。 |
QAccessible::DialogStart | 0x0010 | ダイアログ (QDialog) が可視に設定されました。 |
QAccessible::DocumentContentChanged | 0x0104 | テキストドキュメントの内容が変更されました。 |
QAccessible::DocumentLoadComplete | 0x0105 | 文書が読み込まれました |
QAccessible::DocumentLoadStopped | 0x0106 | 文書の読み込みが停止されました |
QAccessible::DocumentReload | 0x0107 | 文書の再読み込みが開始されました |
QAccessible::DragDropEnd | 0x000F | ドラッグ＆ドロップ操作が終了しようとしています。 |
QAccessible::DragDropStart | 0x000E | ドラッグ＆ドロップが開始されようとしています。 |
QAccessible::Focus | 0x8005 | オブジェクトにキーボードフォーカスが当たった。 |
QAccessible::ForegroundChanged | 0x0003 | ウィンドウがアクティブになった（つまり、新しいウィンドウがデスクトップ上でフォーカスを得た）。 |
QAccessible::HelpChanged | 0x80A0 | オブジェクトのQAccessible::Help text プロパティが変更された。 |
QAccessible::HyperlinkEndIndexChanged | 0x0108 | ハイパーテキストリンクの表示テキストの終了位置が変更された。 |
QAccessible::HyperlinkNumberOfAnchorsChanged | 0x0109 | ハイパーテキストリンクのアンカーの数が変更された。おそらく、複数のリンクを提供するために表示テキストが分割されたため。 |
QAccessible::HyperlinkSelectedLinkChanged | 0x010A | 選択したハイパーテキストリンクのリンクが変更されました。 |
QAccessible::HyperlinkStartIndexChanged | 0x010D | ハイパーテキストリンクの表示テキストの開始位置が変更されました。 |
QAccessible::HypertextChanged | 0x010E | ハイパーテキストリンクの表示テキストが変更されました。 |
QAccessible::HypertextLinkActivated | 0x010B | ハイパーテキストリンクがクリックまたはキー操作によってアクティブになった。 |
QAccessible::HypertextLinkSelected | 0x010C | ハイパーテキストリンクが選択されました。 |
QAccessible::HypertextNLinksChanged | 0x010F | |
QAccessible::IdentifierChanged (since Qt 6.8) | 0x80E0 | オブジェクトの識別子が変更された。 |
QAccessible::LocationChanged | 0x800B | 画面上のオブジェクトの位置が変わった。 |
QAccessible::MenuCommand | 0x0018 | メニュー項目がトリガーされた。 |
QAccessible::MenuEnd | 0x0005 | メニューが閉じられた（Qt はすべてのメニューに PopupMenuEnd を使用します）。 |
QAccessible::MenuStart | 0x0004 | メニューバーでメニューが開かれた（Qt は全てのメニューに PopupMenuStart を使用します）。 |
QAccessible::NameChanged | 0x800C | オブジェクトのQAccessible::Name プロパティが変更された。 |
QAccessible::ObjectAttributeChanged | 0x0110 | |
QAccessible::ObjectCreated | 0x8000 | 新しいオブジェクトが作成された。 |
QAccessible::ObjectDestroyed | 0x8001 | オブジェクトが削除された。 |
QAccessible::ObjectHide | 0x8003 | オブジェクトが非表示になった。例えば、QWidget::hide()。非表示にされたオブジェクトが持つ子オブジェクトは、このイベントを送信しません。オブジェクトが非表示になると、他のオブジェクトによって隠されるため、このイベントは送信されません。 |
QAccessible::ObjectReorder | 0x8004 | レイアウトやアイテムビューがオブジェクトを追加、削除、移動した場合（Qt はこのイベントを使用しません）。 |
QAccessible::ObjectShow | 0x8002 | オブジェクトが表示された。例えば、QWidget::show()。 |
QAccessible::PageChanged | 0x0111 | |
QAccessible::ParentChanged | 0x800F | オブジェクトの親オブジェクトが変更された。 |
QAccessible::PopupMenuEnd | 0x0007 | ポップアップメニューが閉じられた。 |
QAccessible::PopupMenuStart | 0x0006 | ポップアップメニューが開いた。 |
QAccessible::ScrollingEnd | 0x0013 | スクロールバーのスクロール操作が終了した（マウスがスライダーハンドルを離した）。 |
QAccessible::ScrollingStart | 0x0012 | スクロールバーのスクロール操作が始まろうとしている。スライダーハンドルをマウスが押したことなどが原因である。 |
QAccessible::SectionChanged | 0x0112 | |
QAccessible::SelectionAdd | 0x8007 | アイテムビューの選択範囲にアイテムが追加された。 |
QAccessible::SelectionRemove | 0x8008 | アイテムビューの選択範囲からアイテムが削除された。 |
QAccessible::Selection | 0x8006 | メニューまたはアイテムビューで選択範囲が変更された。 |
QAccessible::SelectionWithin | 0x8009 | アイテムビューの選択範囲に複数の変更があった。 |
QAccessible::SoundPlayed | 0x0001 | オブジェクトによってサウンドが再生された |
QAccessible::TableCaptionChanged | 0x0113 | テーブルのキャプションが変更された |
QAccessible::TableColumnDescriptionChanged | 0x0114 | テーブルの列の説明（通常、列のヘッダーにある）が変更された。 |
QAccessible::TableColumnHeaderChanged | 0x0115 | テーブルの列のヘッダーが変更されました。 |
QAccessible::TableRowDescriptionChanged | 0x0117 | 表の行の説明（通常は行のヘッダ）が変更されました。 |
QAccessible::TableRowHeaderChanged | 0x0118 | 表の行ヘッダーが変更されました。 |
QAccessible::TableSummaryChanged | 0x0119 | 表の概要が変更されました。 |
QAccessible::TextColumnChanged | 0x011D | テキスト列が変更されました。 |
QAccessible::VisibleDataChanged | 0x0122 |
この列挙型の値は、IAccessible2仕様およびMSAA仕様で定義されているものと同じである。
QAccessible::Id
QAccessibleInterface キャッシュで使用される unsigned の同義語。
QAccessible::InterfaceFactory
これは、以下のシグネチャを持つ関数へのポインタの型定義である：
typedef QAccessibleInterface *myFactoryFunction(const QString &key, QObject *);
この関数はQString とQObject ポインタを受け取る。QString はインターフェイスを識別するキーである。QObject は、QAccessibleInterface への参照を保持するために渡されます。
キーとQObject に対応するQAccessibleInterface がない場合、nullptr が返されます。
インストールされたファクトリーは、1つがインターフェースを提供するまで、queryAccessibilityInterface()によって呼び出されます。
enum QAccessible::InterfaceType
QAccessibleInterface はいくつかのサブインターフェイスをサポートしています。いくつかのオブジェクトについてより多くの情報を提供するために、それらのアクセシブルな表現は、これらのインターフェースの1つ以上を実装する必要があります。
注意: これらのインターフェースの1つをサブクラス化する場合、QAccessibleInterface::interface_cast() を実装する必要があります。
| 定数 | 値 | 説明 |
|---|---|---|
QAccessible::TextInterface | 0 | 選択をサポートするか、1行以上のテキスト。単純なラベルはこのインタフェースを実装する必要はありません。 |
QAccessible::ValueInterface | 2 | 値を操作するために使われるオブジェクト、例えばスライダーやスクロールバー。 |
QAccessible::ActionInterface | 3 | ユーザーがアクションをトリガーできるインタラクティブなオブジェクト。基本的に、例えばマウス操作のできるものすべて。 |
QAccessible::TableInterface | 5 | リスト、テーブル、ツリー。 |
QAccessible::TableCellInterface | 6 | TableInterfaceオブジェクトのセル。 |
QAccessible::HyperlinkInterface | 7 | ハイパーリンク・ノード（通常はテキスト・ノードの子として埋め込まれます）。 |
QAccessible::SelectionInterface (since Qt 6.5) | 8 | 子オブジェクトの選択をサポートする非テキスト・オブジェクト。 |
QAccessible::AttributesInterface (since Qt 6.8) | 9 | オブジェクト固有の属性をサポートするオブジェクト。 |
QAccessibleInterface::interface_cast(),QAccessibleTextInterface,QAccessibleValueInterface,QAccessibleActionInterface,QAccessibleTableInterface,QAccessibleTableCellInterface,QAccessibleSelectionInterface,QAccessibleAttributesInterfaceも参照してください 。
enum QAccessible::RelationFlag
flags QAccessible::Relation
この列挙型は、2つのアクセス可能なオブジェクト間の関係を示すために組み合わせることができるビットフラグを定義します。relations()関数は、呼び出したオブジェクトのすべての関連インタフェースのリストと、各オブジェクトのリレーションを返します。
リストの各エントリーはQPair で、second メンバには、first メンバで表されるreturned オブジェクトと、origin （呼び出し元）インタフェース/オブジェクトの間の関係タイプが格納されます。
以下の表では、returned オブジェクトは、返されたリスト内のオブジェクトを指し、origin オブジェクトは、呼び出し元のインターフェイスによって表されるものです。
| 定数 | 値 | 説明 |
|---|---|---|
QAccessible::Label | 0x00000001 | returned オブジェクトは、origin オブジェクトのラベルである。 |
QAccessible::Labelled | 0x00000002 | returned オブジェクトはorigin オブジェクトによってラベル付けされます。 |
QAccessible::Controller | 0x00000004 | returned オブジェクトはorigin オブジェクトを制御します。 |
QAccessible::Controlled | 0x00000008 | returned オブジェクトはorigin オブジェクトによって制御されます。 |
QAccessible::DescriptionFor (since Qt 6.6) | 0x00000010 | returned オブジェクトはorigin オブジェクトの説明を提供します。 |
QAccessible::Described (since Qt 6.6) | 0x00000020 | returned オブジェクトはorigin オブジェクトによって記述される。 |
QAccessible::FlowsFrom (since Qt 6.6) | 0x00000040 | コンテンツはreturned オブジェクトからorigin オブジェクトへ論理的に流れる。 |
QAccessible::FlowsTo (since Qt 6.6) | 0x00000080 | コンテンツはorigin オブジェクトからreturned オブジェクトに論理的に流れる。 |
QAccessible::AllRelations | 0xffffffff | すべての関係に関する情報に興味があることを指定するマスクとして使用される。 |
relations() の実装は、これらのフラグの組み合わせを返す。いくつかの値は互いに排他的である。
Relation型はQFlags<RelationFlag>のtypedefである。これは、RelationFlag値のORの組み合わせを格納します。
enum QAccessible::Role
この列挙型は、アクセス可能なオブジェクトの役割を定義します。役割は以下の通りです：
| 定数 | 値 | 説明 |
|---|---|---|
QAccessible::AlertMessage | 0x00000008 | ユーザに警告するためのオブジェクト。 |
QAccessible::Animation | 0x00000036 | アニメーションを表示するオブジェクト |
QAccessible::Application | 0x0000000E | アプリケーションのメインウィンドウ |
QAccessible::Assistant | 0x00000020 | インタラクティブ・ヘルプを提供するオブジェクト |
QAccessible::Border | 0x00000013 | ボーダーを表すオブジェクト |
QAccessible::ButtonDropDown | 0x00000038 | アイテムのリストをドロップダウンするボタン |
QAccessible::ButtonDropGrid | 0x0000003A | グリッドをドロップダウンするボタン |
QAccessible::ButtonMenu | 0x00000039 | メニューをドロップダウンするボタン |
QAccessible::Canvas | 0x00000035 | ユーザが操作できるグラフィックを表示するオブジェクト |
QAccessible::Caret | 0x00000007 | システムキャレット（テキストカーソル）を表すオブジェクト |
QAccessible::Cell | 0x0000001D | テーブルのセル |
QAccessible::Chart | 0x00000011 | データをグラフィカルに表示するオブジェクト |
QAccessible::CheckBox | 0x0000002C | チェックを入れたり外したりできるオプションを表すオブジェクト。オプションの中には、チェック済みでもチェックなしでもないなど、"混合 "状態を提供するものもある。 |
QAccessible::Client | 0x0000000A | ウィンドウのクライアント領域。 |
QAccessible::Clock | 0x0000003D | 時刻を表示する時計。 |
QAccessible::ColorChooser | 0x404 | 色を選択するダイアログ。 |
QAccessible::Column | 0x0000001B | セル(cell) 通常はテーブル内のセルの列。 |
QAccessible::ColumnHeader | 0x00000019 | データ列のヘッダー。 |
QAccessible::ComboBox | 0x0000002E | ユーザーが選択できる選択肢のリスト。 |
QAccessible::ComplementaryContent | 0x42C | ドキュメントやウェブページの、メインコンテンツを補足する部分。通常はランドマーク（WAI-ARIAを参照）。 |
QAccessible::Cursor | 0x00000006 | マウスカーソルを表すオブジェクト。 |
QAccessible::Desktop | 0x00000082 | デスクトップまたはワークスペースを表すオブジェクト。 |
QAccessible::Dial | 0x00000031 | ダイヤルやノブを表すオブジェクト。 |
QAccessible::Dialog | 0x00000012 | ダイアログボックス。 |
QAccessible::Document | 0x0000000F | オフィスアプリケーションなどのドキュメント。 |
QAccessible::EditableText | 0x0000002A | 行やテキスト編集などの編集可能なテキスト。 |
QAccessible::Equation | 0x00000037 | 数式を表すオブジェクト。 |
QAccessible::Footer | 0x40E | ページ内のフッター（通常はドキュメント内）。 |
QAccessible::Form | 0x410 | コントロールを含むWebフォーム。 |
QAccessible::Graphic | 0x00000028 | アイコンなどのグラフィックや画像。 |
QAccessible::Grip | 0x00000004 | ユーザーがドラッグしてウィジェットのサイズを変更できるグリップ。 |
QAccessible::Grouping | 0x00000014 | 他のオブジェクトの論理的なグループ化を表すオブジェクト。 |
QAccessible::Heading | 0x414 | ドキュメント内の見出し。 |
QAccessible::HelpBalloon | 0x0000001F | ヘルプを別の短いウィンドウに表示するオブジェクト。 |
QAccessible::HotkeyField | 0x00000032 | キーシーケンスを入力するためのホットキーフィールド。 |
QAccessible::Indicator | 0x00000027 | 現在の値や項目を表すインジケータ。 |
QAccessible::LayeredPane | 0x00000080 | スタックなど、階層化された子オブジェクトを含むことができるオブジェクト。 |
QAccessible::Link | 0x0000001E | 他の何かへのリンク。 |
QAccessible::List | 0x00000021 | アイテムのリストで、ユーザーが1つ以上のアイテムを選択できる。 |
QAccessible::ListItem | 0x00000022 | アイテムのリスト内のアイテム。 |
QAccessible::MenuBar | 0x00000002 | メニューバー（menu bar） ユーザーがメニューを開く場所。 |
QAccessible::MenuItem | 0x0000000C | メニューまたはメニューバーの項目。 |
QAccessible::NoRole | 0x00000000 | オブジェクトにはロールがありません。これは通常、無効なオブジェクトであることを示す。 |
QAccessible::Note | 0x41B | リソースの主コンテンツの親コンテンツまたは補助コンテンツであるセクション。 |
QAccessible::Notification | 0x00000086 | システムトレイなどの）通知を表すオブジェクト。この役割はLinux上でのみ効果があります。 |
QAccessible::PageTab | 0x00000025 | ユーザーがダイアログで別のページに切り替えるために選択できるページタブ。 |
QAccessible::PageTabList | 0x0000003C | ページタブのリスト。 |
QAccessible::Paragraph | 0x00000083 | テキストの段落（通常、文書に含まれる）。 |
QAccessible::Pane | 0x00000010 | 一般的なコンテナ。 |
QAccessible::PopupMenu | 0x0000000B | ユーザーがアクションを実行するために選択できるオプションをリストしたメニュー。 |
QAccessible::ProgressBar | 0x00000030 | 進行中の操作の進行状況を表示するオブジェクト。 |
QAccessible::PropertyPage | 0x00000026 | ユーザーがオプションや設定を変更できるプロパティページ。 |
QAccessible::Button | 0x0000002B | ボタン。 |
QAccessible::RadioButton | 0x0000002D | 他のオプションと相互に排他的なオプションを表すオブジェクト。 |
QAccessible::Row | 0x0000001C | セル行 通常はテーブル内のセル行。 |
QAccessible::RowHeader | 0x0000001A | データ行のヘッダー。 |
QAccessible::ScrollBar | 0x00000003 | スクロールバー（scroll bar） 可視領域をスクロールするためのバー。 |
QAccessible::Section | 0x00000085 | セクション (文書内の). |
QAccessible::Separator | 0x00000015 | 空間を論理的な領域に分割するセパレータ。 |
QAccessible::Slider | 0x00000033 | スライダー（slider）: 指定された範囲内の値を選択するためのスライダー。 |
QAccessible::Sound | 0x00000005 | サウンドを表すオブジェクト。 |
QAccessible::SpinBox | 0x00000034 | ユーザーが指定された範囲内で値を入力できるようにするスピンボックス・ウィジェット。 |
QAccessible::Splitter | 0x0000003E | 子ウィジェット間で利用可能なスペースを分配するスプリッター。 |
QAccessible::StaticText | 0x00000029 | 他のウィジェットのラベルなどの静的テキスト。 |
QAccessible::StatusBar | 0x00000017 | ステータスバー |
QAccessible::Table | 0x00000018 | 行と列のグリッドでデータを表すテーブル。 |
QAccessible::Terminal | 0x00000081 | ターミナルまたはコマンドラインインターフェイス |
QAccessible::TitleBar | 0x00000001 | ウィンドウのタイトルバーキャプション。 |
QAccessible::ToolBar | 0x00000016 | ユーザーが頻繁にアクセスするウィジェットをグループ化したツールバー。 |
QAccessible::ToolTip | 0x0000000D | 他のオブジェクトに関する情報を提供するツールチップ。 |
QAccessible::Tree | 0x00000023 | ツリー構造内の項目のリスト。 |
QAccessible::TreeItem | 0x00000024 | ツリー構造内のアイテム。 |
QAccessible::UserRole | 0x0000ffff | ユーザ定義ロールに使用される最初の値。 |
QAccessible::WebDocument | 0x00000084 | HTMLドキュメント。 |
QAccessible::Whitespace | 0x0000003B | 他のオブジェクト間の空白。 |
QAccessible::Window | 0x00000009 | トップレベルウィンドウ。 |
enum QAccessible::Text
この列挙型は、アクセス可能なオブジェクトが返す文字列情報を指定します。
| 定数 | 値 | 説明 |
|---|---|---|
QAccessible::Name | 0 | オブジェクトの名前。これは、識別子としても、アクセス可能なクライアントによる短い説明としても使用できます。 |
QAccessible::Description | 1 | オブジェクトを説明する短いテキスト。 |
QAccessible::Value | 2 | オブジェクトの値。 |
QAccessible::Help | 3 | オブジェクトの使用方法に関する情報を与える長いテキスト。 |
QAccessible::Accelerator | 4 | オブジェクトのデフォルトアクションを実行するキーボードショートカット。 |
QAccessible::UserText | 0x0000ffff | ユーザー定義テキストに使われる最初の値。 |
QAccessible::Identifier (since Qt 6.8) | 6 | UIテストなどのためのオブジェクトの識別子。 |
enum QAccessible::TextBoundaryType
この列挙型は、異なるタイプのテキスト境界を記述する。これは IAccessible2 API に従っており、QAccessibleTextInterface で使用されています。
| 定数 | 値 | 説明 |
|---|---|---|
QAccessible::CharBoundary | 0 | 個々の文字を境界として使用する。 |
QAccessible::WordBoundary | 1 | 単語を境界として使用する。 |
QAccessible::SentenceBoundary | 2 | 境界として文を使用する。 |
QAccessible::ParagraphBoundary | 3 | 段落を境界として使用する。 |
QAccessible::LineBoundary | 4 | 改行を境界として使用する。 |
QAccessible::NoBoundary | 5 | 境界なし （テキス ト 全体を使用）。 |
メンバー関数 ドキュメンテーション
[static] QAccessibleInterface *QAccessible::accessibleInterface(QAccessible::Id id)
id に属するQAccessibleInterface を返す。
id が無効な場合はnullptr を返す。
[static] void QAccessible::deleteAccessibleInterface(QAccessible::Id id)
このid に属するインタフェースをキャッシュから削除します。id は無効になり、キャッシュによって再利用される可能性があります。
[static] void QAccessible::installFactory(QAccessible::InterfaceFactory factory)
InterfaceFactory factory をインストールします。最後に追加されたファクトリーは、queryAccessibleInterface() によって最初に使用されるファクトリーです。
[static] bool QAccessible::isActive()
プラットフォームがアクセシビリティ情報を要求した場合、true を返す。
スクリーンリーダーなどのツールがアクセシビリティフレームワークにアクセスするまで、この関数はfalseを返します。アクセシビリティが有効でない場合でも、QAccessible::queryAccessibleInterface （）を使用することは可能である。しかし、プラットフォームへの通知はありません。
不要なときにupdateAccessibility() を使って高価な通知が行われるのを防ぐために、この関数を使うことを推奨する。
[static] QAccessibleInterface *QAccessible::queryAccessibleInterface(QObject *object)
与えられたobject に対応するQAccessibleInterface 実装が存在する場合、この関数はその実装へのポインタを返し、そうでない場合はnullptr を返します。
この関数は、object のクラスのインタフェースを提供するものが見つかるまで、インストールされているすべてのファクトリ関数を呼び出します（最も最近インストールされたものから最も最近インストールされたものまで）。 クラスのアクセシビリティ実装を提供できるファクトリがない場合、この関数はインストールされているアクセシビリティプラグインをロードし、プラグインのいずれかが実装を提供できるかどうかをテストします。
オブジェクトのクラスの実装が利用できない場合、関数は上記の戦略を使用して、オブジェクトの親クラスの実装を見つけようとします。
すべてのインターフェースは内部キャッシュによって管理され、削除されるべきではありません。
[static] QAccessible::Id QAccessible::registerAccessibleInterface(QAccessibleInterface *iface)
手動で作成したインターフェースが適切にメモリ管理されるように、この関数を呼び出します。
1つのインターフェースにつき、正確に1回だけ呼び出されなければなりませんiface 。この関数は、queryAccessibleInterface を呼び出すときに暗黙的に呼び出されます。この関数を呼び出す必要があるのは、QAccessibleInterface を "new" 演算子でインスタンス化するときだけです。可能な限りデフォルト関数を使用し、queryAccessibleInterface() にこの処理を任せるようにしてください。
QAccessibleInterface::child() 関数を再実装し、構築後に子を返す必要がある場合は、この関数を呼び出す必要があります。
[static] void QAccessible::removeFactory(QAccessible::InterfaceFactory factory)
インストールされている InterfaceFactories のリストからfactory を削除します。
[static] void QAccessible::setRootObject(QObject *object)
このアプリケーションのアクセス可能なオブジェクトのルート・オブジェクトをobject に設定します。他のすべてのアクセス可能なオブジェクトは、ルートオブジェクトからオブジェクトナビゲーションを使用して到達可能です。
Qt はQApplication::exec() でイベントループに入る直前にQApplication オブジェクトをルートオブジェクトとして設定するので、通常はこの関数を呼び出す必要はありません。
QAccessible::installRootObjectHandler()を使用して、関数呼び出しをカスタマイズされたハンドラ関数にリダイレクトしてください。
queryAccessibleInterface()も参照してください 。
[static] QAccessible::Id QAccessible::uniqueId(QAccessibleInterface *iface)
QAccessibleInterface iface の一意の ID を返します。
[static] void QAccessible::updateAccessibility(QAccessibleEvent *event)
アクセシビリティクライアントに関連するかもしれない変更について通知します。
event は変更の詳細を提供します。これには、変更元と変更の性質が含まれます。 は、意味のある通知を行うのに十分な情報を含むべきである。event
例えば、ValueChange はスライダーの位置が変更されたことを示します。
この関数は、アクセシブル・オブジェクトまたはそのサブ要素の状態が、プログラム的に（たとえば、QLabel::setText （）を呼び出すことによって）、またはユーザーとの対話によって変更されたときに呼び出します。
このイベントをリッスンしているアクセシビリティ・ツールがない場合、この関数を呼び出すことによるパフォーマンス・ペナルティはほとんどありませんが、呼び出しのパラメータを決定するのに時間がかかる場合は、不要な計算を避けるためにQAccessible::isActive() をテストすることができます。
本書に含まれる文書の著作権は、それぞれの所有者に帰属します。 本書で提供されるドキュメントは、Free Software Foundation が発行したGNU Free Documentation License version 1.3に基づいてライセンスされています。 Qtおよびそれぞれのロゴは、フィンランドおよびその他の国におけるThe Qt Company Ltd.の 商標です。その他すべての商標は、それぞれの所有者に帰属します。
