QAccessibleActionInterface Class
QAccessibleActionInterface クラスは、インターフェース内で呼び出し可能なアクションのサポートを実装しています。詳細...
| ヘッダー: | #include <QAccessibleActionInterface> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS Gui) target_link_libraries(mytarget PRIVATE Qt6::Gui) |
| qmake: | QT += gui |
| 継承元: |
- 継承されたメンバーを含むすべてのメンバーの一覧
- QAccessibleActionInterface は、アクセシビリティクラス群の一部です。
パブリック関数
| QAccessibleActionInterface() | |
| virtual | ~QAccessibleActionInterface() |
| virtual QStringList | actionNames() const = 0 |
| virtual void | doAction(const QString &actionName) = 0 |
| virtual QStringList | keyBindingsForAction(const QString &actionName) const = 0 |
| virtual QString | localizedActionDescription(const QString &actionName) const |
| virtual QString | localizedActionName(const QString &actionName) const |
静的パブリックメンバー
| const QString & | decreaseAction() |
| const QString & | increaseAction() |
| QString | nextPageAction() |
| const QString & | pressAction() |
| QString | previousPageAction() |
| QString | scrollDownAction() |
| QString | scrollLeftAction() |
| QString | scrollRightAction() |
| QString | scrollUpAction() |
| const QString & | setFocusAction() |
| const QString & | showMenuAction() |
| const QString & | showOnScreenAction() |
| const QString & | toggleAction() |
詳細な説明
アクセシビリティ対応オブジェクトは、ユーザーとの対話機能をサポートしている場合、このアクションインターフェースを実装する必要があります。通常、このインターフェースは、QAccessibleInterface も実装しているクラスによって実装されます。
サポートされるアクションは、あらかじめ定義されたアクションに当てはまらない場合を除き、このクラスで提供されるあらかじめ定義されたアクションを使用する必要があります。その場合は、カスタムアクションを追加することができます。
QAccessibleActionInterface をサブクラス化する際は、利用可能なアクションを検出するための主要な手段である `actionNames ` のリストを指定する必要があります。 アクション名は決してローカライズされません。ユーザーにアクションを表示するためには、名前のローカライズ版を返し、アクションの説明を提供する2つの関数が必要です。事前定義されたアクション名については、QAccessibleActionInterface::localizedActionName() およびQAccessibleActionInterface::localizedActionDescription() を使用して、それぞれのローカライズ版を返してください。
一般的に、以下のいずれにも当てはまらないアクションを記述する場合を除き、事前定義されたアクション名のいずれかを使用する必要があります：
| アクション名 | 説明 |
|---|---|
| toggleAction() | 項目（チェックボックス、ラジオボタン、スイッチなど）のオン／オフを切り替えます |
| decreaseAction() | 入力可能なフィールド（例：スピンボックス）の値を減少させる |
| increaseAction() | アクセシブル（例：スピンボックス）の値を増加させる |
| pressAction() | アクセシブルな要素（例：スピンボックス）を押す、クリックする、またはアクティブにする（マウスでオブジェクトをクリックすることに対応する） |
| setFocusAction() | このアクセシブルにフォーカスを合わせる |
| showOnScreenAction() | このアクセシブルをビューポート内に移動させる |
| showMenuAction() | コンテキストメニューを表示する（右クリックに相当する） |
アクションを呼び出すには、アクション名を引数としてdoAction()を呼び出します。
ほとんどのウィジェットは、単に `pressAction()` を実装します。これは、クリックやスペースキーの押下などによってウィジェットがアクティブになったときに実行されます。
メンバ関数のドキュメント
[constexpr noexcept default] QAccessibleActionInterface::QAccessibleActionInterface()
QAccessibleActionInterface のインスタンスをデフォルトコンストラクタで生成します。
[virtual noexcept] QAccessibleActionInterface::~QAccessibleActionInterface()
QAccessibleActionInterface を削除します。
[pure virtual] QStringList QAccessibleActionInterface::actionNames() const
このアクセシブルオブジェクトがサポートするアクションのリストを返します。返されるアクションは優先順位の高い順に並べる必要があります。つまり、ユーザーが実行したい可能性が最も高いアクションを最初に返し、実行したい可能性が最も低いアクションを最後に返すようにします。
このリストには、呼び出し可能なアクションのみが含まれます。無効化されたアクションや、無効化された UI コントロールに関連付けられたアクションは返されません。
リストが空の場合もあります。
なお、このリストはローカライズされていません。ローカライズされた表現を得るには、localizedActionName() およびlocalizedActionDescription() を再実装してください。
doAction()、localizedActionName()、およびlocalizedActionDescription()も参照してください 。
[static] const QString &QAccessibleActionInterface::decreaseAction()
「decrease」のデフォルトアクションの名前を返します。
actionNames() およびlocalizedActionName()も参照してください 。
[pure virtual] void QAccessibleActionInterface::doAction(const QString &actionName)
actionName で指定されたアクションを呼び出します。なお、actionName は、actionNames()によって返されるローカライズされていない名前であることに注意してください。この関数は通常、オブジェクトのクリックなど、他のユーザー操作によってトリガーされるのと同じ関数を呼び出すことで実装されます。
actionNames()も参照してください 。
[static] const QString &QAccessibleActionInterface::increaseAction()
「increase」のデフォルトアクション名を返します。
actionNames() およびlocalizedActionName()も参照してください 。
[pure virtual] QStringList QAccessibleActionInterface::keyBindingsForAction(const QString &actionName) const
actionName という名前のアクションを呼び出すために使用可能なキーボードショートカットの一覧を返します。
キーボード操作を重視することで、ユーザーにアプリケーションの別の利用方法を学んでもらう上で重要です。
actionNames()も参照してください 。
[virtual] QString QAccessibleActionInterface::localizedActionDescription(const QString &actionName) const
アクション `actionName` のローカライズされた説明を返します。
デフォルト名のいずれかを使用する場合、QAccessibleActionInterface 内でこの関数を呼び出すことで、ローカライズされた文字列を取得できます。
actionNames() およびlocalizedActionName()も参照してください 。
[virtual] QString QAccessibleActionInterface::localizedActionName(const QString &actionName) const
actionName のローカライズされたアクション名を返します。
カスタムアクションの場合、この関数を再実装する必要があります。デフォルト名のいずれかを使用する場合は、QAccessibleActionInterface 内でこの関数を呼び出すことで、ローカライズされた文字列を取得できます。
actionNames() およびlocalizedActionDescription()も参照してください 。
[static] QString QAccessibleActionInterface::nextPageAction()
次のページのデフォルトアクションの名前を返します。
actionNames() およびlocalizedActionName()も参照してください 。
[static] const QString &QAccessibleActionInterface::pressAction()
press のデフォルトアクションの名前を返します。
actionNames() およびlocalizedActionName()も参照してください 。
[static] QString QAccessibleActionInterface::previousPageAction()
前のページのデフォルトアクションの名前を返します。
actionNames() およびlocalizedActionName()も参照してください 。
[static] QString QAccessibleActionInterface::scrollDownAction()
スクロールダウン時のデフォルトアクションの名前を返します。
actionNames() およびlocalizedActionName()も参照してください 。
[static] QString QAccessibleActionInterface::scrollLeftAction()
スクロール左のデフォルトアクションの名前を返します。
actionNames() およびlocalizedActionName()も参照してください 。
[static] QString QAccessibleActionInterface::scrollRightAction()
スクロール右のデフォルトアクションの名前を返します。
actionNames() およびlocalizedActionName()も参照してください 。
[static] QString QAccessibleActionInterface::scrollUpAction()
スクロールアップのデフォルトアクションの名前を返します。
actionNames() およびlocalizedActionName()も参照してください 。
[static] const QString &QAccessibleActionInterface::setFocusAction()
フォーカスが設定された際のデフォルトアクションの名前を返します。
actionNames() およびlocalizedActionName()も参照してください 。
[static] const QString &QAccessibleActionInterface::showMenuAction()
ショーメニューのデフォルトアクションの名前を返します。
actionNames() およびlocalizedActionName()も参照してください 。
[static] const QString &QAccessibleActionInterface::showOnScreenAction()
画面に表示される番組名のデフォルトの動作を返します。
actionNames() およびlocalizedActionName()も参照してください 。
[static] const QString &QAccessibleActionInterface::toggleAction()
トグルのデフォルトアクションの名前を返します。
actionNames() およびlocalizedActionName()も参照してください 。
© 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.
