次の方法で共有

ツリー ビュー コントロール (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_SELECTED | STATE_SYSTEM_HOTTRACKED
get_accValue ツリー ビュー オブジェクトには値がありません。 各ツリー ビュー項目の Value プロパティは、階層内の項目のインデント レベルです。 たとえば、Windows エクスプローラーでは、"Desktop" アイテムの Value プロパティは "0" です。階層内の次のレベルにあるアイテム "My Computer" には、"1" の Value プロパティがあります。階層の次のレベルにある各ディスク ドライブには、"2" の Value プロパティがあります。

筆記

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

IAccessible インターフェイス の