QAccessibleActionInterface Class
QAccessibleActionInterface クラスは、呼び出し可能なアクションのサポートを実装したインターフェイスです。さらに...
| ヘッダ | #include <QAccessibleActionInterface> |
| CMake： | find_package(Qt6 REQUIRED COMPONENTS Gui)target_link_libraries(mytarget PRIVATE Qt6::Gui) |
| qmake： | QT += gui |
| 継承元： |
- 継承メンバを含む全メンバのリスト
- 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 & | toggleAction() |
詳細説明
アクセシブル・オブジェクトは、ユーザーとのインタラクションをサポートする場合、アクション・インタフェースを実装する必要があります。通常、このインターフェースは、QAccessibleInterface を実装するクラスによって実装されます。
サポートされるアクションは、定義済みのアクションに適合しない場合を除き、このクラスで提供される定義済みのアクションを使用する必要があります。その場合、カスタム・アクションを追加することができます。
QAccessibleActionInterfaceをサブクラス化する際には、利用可能なアクションを発見するための主要な手段であるactionNames のリストを提供する必要があります。アクション名は決してローカライズされません。ユーザーにアクションを提示するためには、ローカライズされた名前のバージョンを返し、アクションの説明を与える2つの関数が必要です。定義済みのアクション名については、QAccessibleActionInterface::localizedActionName() とQAccessibleActionInterface::localizedActionDescription() を使用して、ローカライズされたものを返します。
一般的には、定義済みのアクション名のいずれかを使うべきですが、これに当てはまらないアクションを記述する場合は別です：
| アクション名 | 説明 |
|---|---|
| toggleAction() | 項目を切り替えます (チェックボックス、ラジオボタン、スイッチ、...) |
| decreaseAction() | アクセス可能な値を減少させる (例: スピンボックス) |
| increaseAction() | アクセス可能な項目 (スピンボックスなど) の値を増やします。 |
| pressAction() | アクセス可能なオブジェクトを押す、クリックする、またはアクティブにする（マウスでオブジェクトをクリックすることに対応する必要があります） |
| setFocusAction() | このアクセシブルにフォーカスを合わせる |
| showMenuAction() | コンテキストメニューを表示する。 |
アクションを呼び出すには、doAction() をアクション名とともに呼び出します。
ほとんどのウィジェットは、単純にpressAction() を実装します。これは、ウィジェットがクリックされたり、スペースキーが押されたりしてアクティブになったときに起こります。
メンバ関数ドキュメント
[virtual noexcept] QAccessibleActionInterface::~QAccessibleActionInterface()
QAccessibleActionInterface を破壊する。
[pure virtual] QStringList QAccessibleActionInterface::actionNames() const
このアクセス可能なオブジェクトがサポートするアクションのリストを返す。返されるアクションは優先される順番であるべきです。 つまり、ユーザが一番発動させたいアクションが最初に返され、 一番発動させたくないアクションが最後に返されるべきです。
リストは起動可能なアクションのみを含みます。無効化されたアクションや、無効化されたUIコントロールに関連するアクションは返されません。
リストは空でもかまいません。
このリストはローカライズされていないことに注意してください。ローカライズされた表現については、localizedActionName() とlocalizedActionDescription() を再実装してください。
doAction()、localizedActionName()、localizedActionDescription()も参照 。
[static] const QString &QAccessibleActionInterface::decreaseAction()
減少したデフォルトアクションの名前を返します。
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()
scroll up デフォルトのアクション名を返します。
actionNames() およびlocalizedActionName()も参照 ください。
[static] const QString &QAccessibleActionInterface::setFocusAction()
設定されているフォーカスのデフォルトアクションの名前を返します。
actionNames() およびlocalizedActionName()も参照 ください。
[static] const QString &QAccessibleActionInterface::showMenuAction()
show menu デフォルトのアクション名を返します。
actionNames() およびlocalizedActionName()も参照 。
[static] const QString &QAccessibleActionInterface::toggleAction()
toggle デフォルトアクションの名前を返します。
actionNames() およびlocalizedActionName()も参照 ください。
© 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.
