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 の 0 基準のインデックスを返すか、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 を返します。