List-View コントロール (MSAA UI 要素リファレンス)

  • [アーティクル]

注意

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

リスト ビュー コントロールは、アイコンとラベルで構成される項目のコレクションを表示し、項目を表示および配置するいくつかの方法を提供します。 たとえば、各項目に関する追加情報は、アイコンとラベルの右側の列に表示されます。 Windows エクスプローラーでは、リスト ビュー コントロールを使用してファイルを表示します。

リスト ビュー コントロールのウィンドウ クラス名は、commctrl.h で "SysListView" として定義WC_LISTVIEW。

IAccessible メソッド

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

メソッド 説明
accDoDefaultAction リスト ビュー オブジェクト自体には DefaultAction プロパティがありません。ただし、 accDoDefaultAction メソッドはリスト ビュー項目をダブルクリックします。
accHitTest
accLocation
accNavigate
accSelect

IAccessible プロパティ

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

プロパティ 説明
get_accChild
get_accChildCount ChildCount プロパティは、リスト内の項目の数です。
get_accDefaultAction リスト ビュー オブジェクト自体には DefaultAction プロパティがありません。ただし、各リスト ビュー アイテムの DefaultAction プロパティは "ダブルクリック" です。
get_accDescription リスト ビュー オブジェクト自体は Description プロパティをサポートしていません。ただし、各リスト ビュー アイテムの Description プロパティは、アイテムの 2 番目以降の列に含まれるテキストです。 各列のテキストの間にコンマが挿入されます。
get_accFocus
get_accHelp
get_accHelpTopic
get_accKeyboardShortcut リスト ビュー オブジェクトにはキーボード ショートカットがありません。 ただし、リスト ビュー コントロールのウィンドウ テキストにアンパサンド (&) 文字が含まれている場合、Microsoft Active Accessibility は KeyboardShortcut プロパティとして Null 以外の文字列を返します。
get_accName リスト ビュー オブジェクトの Name は、コントロールのウィンドウ テキスト (またはキャプション) から取得します。 このテキストはリスト ビュー コントロールと共に表示されないため、サーバー開発者は、クライアント ユーティリティのユーザーがコントロールを識別できるように、コントロールのリソース定義ステートメントで意味のあるテキストを提供する必要があります。 リスト ビュー項目の場合、 Name プロパティはリスト アイテムのテキストです。
get_accParent リスト ビュー オブジェクトの Parent は、コントロールを囲み、コントロールと同じ Name プロパティとウィンドウ クラス名を持つウィンドウ ( ROLE_SYSTEM_WINDOW ) です。 リスト ビュー項目の Parent プロパティは、リスト ビュー オブジェクトです。
get_accRole ROLE_SYSTEM_LISTの Role とリスト ビュー コントロールの各項目には、ROLE_SYSTEM_LISTITEMの Role プロパティがあります。
get_accSelection
get_accState リスト ビュー オブジェクトの State プロパティは、次の値の 1 つ以上の組み合わせです。STATE_SYSTEM_INVISIBLE STATE_SYSTEM_UNAVAILABLE | STATE_SYSTEM_FOCUSED | STATE_SYSTEM_FOCUSABLE | STATE_SYSTEM_OFFSCREEN |
リスト ビューアイテムの State プロパティは、次の 1 つ以上の値の組み合わせです。
| STATE_SYSTEM_INVISIBLE | STATE_SYSTEM_FOCUSED | STATE_SYSTEM_FOCUSABLE | STATE_SYSTEM_SELECTABLE | STATE_SYSTEM_SELECTED | STATE_SYSTEM_MULTISELECTABLE | STATE_SYSTEM_HOTTRACKED | STATE_SYSTEM_OFFSCREENSTATE_SYSTEM_NORMAL
さらに、チェック ボックスのリスト ビューアイテムにも状態STATE_SYSTEM_CHECKEDがあります。

メモ

  • Microsoft Active Accessibility では、コールバック関数を使用してアイテムにテキストを追加するアプリケーションのリスト ビュー アイテム テキストは公開されません。
  • クリップされたリスト ビュー項目には 、STATE_SYSTEM_INVISIBLE が設定されていません。 リスト アイテムがクリップされているかどうかを判断するために、クライアントは accLocation によって返されるアイテムの座標とウィンドウのクリッピング領域を比較できます。
  • Microsoft Active Accessibility では、 accNavigate メソッドを使用して、詳細ビューにあるリスト ビュー コントロール内のヘッダー コントロールに移動することはできません。 ただし、クライアントは AccessibleObjectFromPoint 関数を使用してヘッダー コントロールにアクセスします。
  • 詳細ビューのリスト ビュー項目などの四角形以外のオブジェクトの場合、accHitTest でテストすると accHitTest によってピクセル単位でオブジェクトの境界が決定されるため、accLocation によって取得された項目の外接する四角形の座標は失敗します。

IAccessible インターフェイス