QAccessibleInterface Class

メンバ関数ドキュメント

[virtual noexcept protected] QAccessibleInterface::~QAccessibleInterface()

QAccessibleInterface を破壊する。

QAccessibleActionInterface *QAccessibleInterface::actionInterface()

[virtual] QColor QAccessibleInterface::backgroundColor() const

アクセス可能な背景色がある場合はその色を返し、ない場合は無効なQColor を返す。

foregroundColor()も参照 。

[pure virtual] QAccessibleInterface *QAccessibleInterface::child(int index) const

インデックスindex を持つアクセス可能な子を返します。0ベースのインデックス。オブジェクトの子の数はchildCount で確認できます。

無効な子プロセスを要求した場合 (たとえば、子プロセスが途中で無効になった場合など)、nullptr を返します。

childCount() およびparent()も参照 。

[pure virtual] QAccessibleInterface *QAccessibleInterface::childAt(int x, int y) const

スクリーン座標 (x,y) を含む子のQAccessibleInterface を返す。この位置に子がない場合、この関数はnullptr を返す。返されるアクセス可能な子は子でなければなりませんが、必ずしも直接の子である必要はありません。

この関数は可視オブジェクトに対してのみ信頼できます（不可視オブジェクトは正しくレイアウトされない可能性があります）。

すべてのビジュアル・オブジェクトはこの情報を提供します。

QAccessibleObject を継承するオブジェクトには、デフォルトの実装が用意されています。これは、すべての子オブジェクトを繰り返し処理します。ウィジェットが子オブジェクトを管理する場合（テーブルなど）、専用の実装を書いた方が効率的です。

rect()も参照してください 。

[pure virtual] int QAccessibleInterface::childCount() const

このオブジェクトに属する子の数を返します。子オブジェクトは、それ自身でアクセシビリティ情報を提供することもできますし（子ウィジェットなど）、このアクセシブル・オブジェクトのサブ要素となることもできます。

すべてのオブジェクトがこの情報を提供します。

indexOfChild()も参照してください 。

[virtual] QAccessibleInterface *QAccessibleInterface::focusChild() const

キーボード・フォーカスを持つオブジェクトを返します。

返されるオブジェクトは、自分自身を含む、どの子孫でもかまいません。

[virtual] QColor QAccessibleInterface::foregroundColor() const

QColorアクセシブルの前景色を返す（該当する場合）。

backgroundColor()も参照 。

[pure virtual] int QAccessibleInterface::indexOfChild(const QAccessibleInterface *child) const

child child がこのオブジェクトの子でない場合は -1。

すべてのオブジェクトは、子オブジェクトに関するこの情報を提供します。

childCount()も参照してください 。

[virtual] void *QAccessibleInterface::interface_cast(QAccessible::InterfaceType type)

一般的なQAccessibleInterface から、特化されたアクセシビリティインタフェースtype を返す。

この関数は、特殊化されたインターフェイスを通して、ウィジェットやオブジェクトに関するより多くの情報を提供するときに、再実装されなければなりません。例えば、ライン編集はQAccessibleTextInterface を実装する必要があります。

QAccessible::InterfaceType,QAccessibleTextInterface,QAccessibleValueInterface,QAccessibleActionInterface,QAccessibleTableInterface,QAccessibleTableCellInterfaceも参照してください 。

[pure virtual] bool QAccessibleInterface::isValid() const

このインターフェイス実装を使用するために必要なすべてのデータが有効な場合（たとえば、すべてのポインタが非NULL）、true を返します。そうでない場合は、false を返します。

object()も参照 。

[pure virtual] QObject *QAccessibleInterface::object() const

このインターフェース実装が情報を提供するQObject へのポインタを返す。

isValid()も参照してください 。

[pure virtual] QAccessibleInterface *QAccessibleInterface::parent() const

アクセス可能なオブジェクト階層における親のQAccessibleInterface を返します。

親が存在しない場合はnullptr を返します (例えば、トップレベルのアプリケーションオブジェクト)。

child()も参照してください 。

[pure virtual] QRect QAccessibleInterface::rect() const

オブジェクトのジオメトリを返します。ジオメトリはスクリーン座標です。

この関数は可視オブジェクトに対してのみ信頼できます（不可視オブジェクトは正しくレイアウトされないかもしれません）。

すべての可視オブジェクトはこの情報を提供します。

childAt()も参照してください 。

[virtual] QList<QPair<QAccessibleInterface *, QAccessible::Relation>> QAccessibleInterface::relations(QAccessible::Relation match = QAccessible::AllRelations) const

他のウィジェットとの意味のある関係を返します。通常、ツリービューなどの特殊な方法で処理されない限り、親子関係は返されません。通常、labelled-by と label の関係を返します。

オプションのパラメータmatch を使用して、関係をフィルタリングすることができます。この関数は決してそれ自身を返してはならない。

parent() およびchild()も参照 。

[pure virtual] QAccessible::Role QAccessibleInterface::role() const

オブジェクトのロールを返します。オブジェクトのロールは通常静的です。

アクセス可能なオブジェクトはすべてロールを持ちます。

text() およびstate()も参照 ください。

[since 6.5] QAccessibleSelectionInterface *QAccessibleInterface::selectionInterface()

この関数はQt 6.5で導入されました。

[pure virtual] void QAccessibleInterface::setText(QAccessible::Text t, const QString &text)

オブジェクトのテキスト・プロパティt をtext に設定します。

ほとんどのオブジェクトのテキスト・プロパティは読み取り専用なので、この関数を呼んでも何の効果もないことに注意してください。

text()も参照してください 。

[pure virtual] QAccessible::State QAccessibleInterface::state() const

オブジェクトの現在の状態を返します。返される値は、QAccessible::StateFlag 列挙のフラグの組み合わせです。

すべてのアクセス可能なオブジェクトは状態を持っています。

text() およびrole()も参照して ください。

QAccessibleTableCellInterface *QAccessibleInterface::tableCellInterface()

QAccessibleTableInterface *QAccessibleInterface::tableInterface()

[pure virtual] QString QAccessibleInterface::text(QAccessible::Text t) const

オブジェクトの text プロパティt の値を返す。

QAccessible::Name は、ユーザーがアクセス可能なオブジェクトを識別、検索、告知するためにクライアントが使用する文字列です。すべてのオブジェクトは、そのコンテナ内で一意な名前を持つ必要があります。名前はクライアントによって使い分けられるので、オブジェクトの簡単な説明を与え、かつ一意でなければなりません。

アクセシブル・オブジェクトのQAccessible::Description は、オブジェクトの外観に関するテキスト情報を提供します。説明文は主に視覚に障害のあるユーザーに大きな文脈を提供するために使用されますが、文脈検索や他のアプリケーションにも使用されます。すべてのオブジェクトに説明があるわけではありません。OK」ボタンには説明は必要ありませんが、スマイルの絵を表示するツールボタンには説明が必要です。

アクセシブルオブジェクトのQAccessible::Value は、そのオブジェクトに含まれる視覚的な情報、例えば行編集のテキストを表します。通常、値はユーザーが変更できます。すべてのオブジェクトが値を持つわけではありません。例えば、静的なテキストラベルはそうではありませんし、トグルボタンなど、すでに値となっている状態を持つオブジェクトもあります。

QAccessible::Help テキストは、アクセシブル・オブジェクトの機能と使用法に関する情報を提供します。すべてのオブジェクトがこの情報を提供するわけではありません。

QAccessible::Accelerator は、オブジェクトのデフォルトアクションをアクティブにするキーボードショートカットです。キーボードショートカットは、メニュー、メニューアイテム、ウィジェットのテキストにある下線文字で、その文字そのものか、その文字とAlt、Ctrl、Shiftなどの修飾キーの組み合わせです。ツールボタンのようなコマンドコントロールにもショートカットキーがあり、通常はツールチップに表示されます。

QAccessible::Identifier 、支援技術にIDを提供するように明示的に設定することができます。これは特にUIテストに役立ちます。識別子が明示的に設定されていない場合、識別子は、QObject::objectName またはそのクラス名と、QObject::objectName またはその親チェーンの親のクラス名に基づく ID に、それぞれのインターフェースによって設定されます。

すべてのオブジェクトはQAccessible::Name の文字列を提供する。

setText(),role(),state()も参照 。

QAccessibleTextInterface *QAccessibleInterface::textInterface()

QAccessibleValueInterface *QAccessibleInterface::valueInterface()

[virtual] QWindow *QAccessibleInterface::window() const

基礎となるオブジェクトに関連付けられたウィンドウを返す。例えば、QAccessibleWidget はこれを再インプリメントし、QWidget の windowHandle() を返す。

これは、ATクライアントに状態の変化を通知できるようにするために、いくつかのプラットフォームで使用されます。バックエンドはウィンドウを見つけるまで、すべての祖先をたどる。(これは、先祖のうち少なくとも1つのインターフェイスが有効なQWindow ポインタを返す必要があることを意味する）。

デフォルトの実装はnullptr を返します。