QAccessibleActionInterface Class
QAccessibleActionInterface クラスは、呼び出し可能なアクションのサポートを実装したインターフェイスです。詳細...
| Header: | #include <QAccessibleActionInterface> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS Gui)target_link_libraries(mytarget PRIVATE Qt6::Gui) |
| qmake: | QT += gui |
| Inherited By: |
- 継承メンバを含む全メンバ一覧
- 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()
scroll down default アクション名を返します。
actionNames() およびlocalizedActionName()も 参照。
[static] QString QAccessibleActionInterface::scrollLeftAction()
scroll left デフォルトのアクション名を返します。
actionNames() およびlocalizedActionName() も参照 。
[static] QString QAccessibleActionInterface::scrollRightAction()
scroll right デフォルトのアクション名を返します。
actionNames() およびlocalizedActionName()も 参照。
[static] QString QAccessibleActionInterface::scrollUpAction()
scroll up デフォルトのアクション名を返します。
actionNames() およびlocalizedActionName() も参照 。
[static] const QString &QAccessibleActionInterface::setFocusAction()
set focus default アクション名を返します。
actionNames() およびlocalizedActionName() も参照 。
[static] const QString &QAccessibleActionInterface::showMenuAction()
show menu default アクションの名前を返します。
actionNames() およびlocalizedActionName() も参照 。
[static] const QString &QAccessibleActionInterface::toggleAction()
toggle default アクション名を返します。
actionNames() およびlocalizedActionName() も参照して ください。
本ドキュメントに含まれる文書の著作権は、それぞれの所有者に帰属します。 本書で提供されるドキュメントは、Free Software Foundation が発行したGNU Free Documentation License version 1.3に基づいてライセンスされています。 Qtおよびそれぞれのロゴは、フィンランドおよびその他の国におけるThe Qt Company Ltd.の 商標です。その他すべての商標は、それぞれの所有者に帰属します。
