次の方法で共有


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

手記

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

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

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

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 プロパティはリスト アイテムのテキストです。
get_accParent リスト ビュー オブジェクトの は、コントロールを囲み、コントロールと同じ Name プロパティとウィンドウ クラス名を持つウィンドウ (ROLE_SYSTEM_WINDOW) です。 リスト ビュー アイテムの Parent プロパティは、リスト ビュー オブジェクトです。
get_accRole ROLE_SYSTEM_LISTRole、およびリスト ビュー コントロール内の各項目には、ROLE_SYSTEM_LISTITEMRole プロパティがあります。
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_OFFSCREEN | STATE_SYSTEM_NORMAL
さらに、チェック ボックスのリスト ビュー項目にも状態 STATE_SYSTEM_CHECKEDがあります。

筆記

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

IAccessible インターフェイス