ツリー ビュー コントロール (MSAA UI 要素リファレンス)

  • [アーティクル]

注意

このトピックでは、MSAA UI 要素リファレンスの目的で ツリー ビュー コントロール オブジェクトについて説明します。 さまざまな UI フレームワークで ツリー ビュー コントロール オブジェクトを作成する方法については、ここでは説明しません。 使用している UI フレームワークの API リファレンス ドキュメントを参照してください。

ツリー ビュー コントロールは、階層内の関連アイテムを接続するために行を使用して項目の階層リストを表示します。 各項目は、ラベルとオプションのビットマップで構成されます。 Windows エクスプローラーでは、ツリー ビュー コントロールを使用してディレクトリを表示します。

ツリー ビュー コントロールのウィンドウ クラス名はWC_TREEVIEWされ、Commctrl.h では "SysTreeView" として定義されます。

IAccessible メソッド

ツリー ビュー コントロールでは、次の IAccessible メソッドがサポートされています。

メソッド 説明
accDoDefaultAction ツリー ビュー オブジェクト自体に accDoDefaultAction メソッドがありません。 ツリー ビューの項目の State プロパティに応じて、 accDoDefaultAction は指定した項目を展開または折りたたみます。
accHitTest
accLocation
accNavigate
accSelect

IAccessible プロパティ

ツリー ビュー コントロールでは、次の IAccessible プロパティが サポートされています。

プロパティ 説明
get_accChild
get_accChildCount ツリー ビュー オブジェクトの ChildCount プロパティは、ツリー ビューに含まれる項目の数です。 各ツリー ビュー項目の ChildCount プロパティは 0 です。
get_accDefaultAction ツリー ビュー オブジェクト自体に DefaultAction プロパティがありません。 展開されたツリー ビューの項目は DefaultAction プロパティとして "Collapse" を持ち、展開されていないアイテムには DefaultAction プロパティとして "Expand" があります。
get_accDescription
get_accFocus
get_accHelp
get_accHelpTopic
get_accKeyboardShortcut
get_accName ツリー ビュー オブジェクトの Name プロパティは、コントロールのウィンドウ テキスト (またはキャプション) から取得されます。 このテキストはツリー ビュー コントロールと共に表示されないため、サーバー開発者は、クライアント ユーティリティのユーザーがコントロールを識別できるように、コントロールのリソース定義ステートメントに意味のあるテキストを指定する必要があります。 ツリー ビューの項目の Name プロパティは、ツリー ビュー項目に表示されるテキストです。
get_accParent ツリー ビュー オブジェクトの Parent プロパティは、コントロールを囲み、コントロールと同じ Name プロパティとウィンドウ クラス名を持つウィンドウ ( ROLE_SYSTEM_WINDOW ) です。 ツリー ビューの各項目の Parent プロパティは、ツリー ビュー オブジェクトです。
get_accRole ツリー ビュー オブジェクトには、 Role プロパティ ROLE_SYSTEM_OUTLINEがあります。 ツリー ビューの各項目には、 Role プロパティ ROLE_SYSTEM_OUTLINEITEMがあります。
get_accSelection
get_accState ツリー ビューの State プロパティは、次の 1 つ以上の値の組み合わせです。STATE_SYSTEM_INVISIBLE STATE_SYSTEM_UNAVAILABLE | | STATE_SYSTEM_FOCUSED | STATE_SYSTEM_FOCUSABLE
ツリー ビュー項目の場合、 State プロパティには STATE_SYSTEM_EXPANDED または STATE_SYSTEM_COLLAPSEDが含まれます。
State プロパティに使用できるその他の値は次のとおりです。
| STATE_SYSTEM_FOCUSED | STATE_SYSTEM_FOCUSABLE | STATE_SYSTEM_SELECTABLE | STATE_SYSTEM_SELECTEDSTATE_SYSTEM_HOTTRACKED
get_accValue ツリー ビュー オブジェクトには値がありません。 各ツリー ビュー項目の Value プロパティは、階層内の項目のインデント レベルです。 たとえば、Windows エクスプローラーでは、アイテム "Desktop" の Value プロパティは "0" です。アイテム "My Computer" は階層内の次のレベルにあり、Value プロパティは "1" で、階層内の次のレベルにある各ディスク ドライブの Value プロパティは "2" です。

Notes

ツリー ビューアイテムの accLocation プロパティは、アイテム内のテキストの位置のみを返します。 ツリー ビュー項目の accLocation によって返される座標には、テキストの左側にあるアイコンは含まれません。

IAccessible インターフェイス