ListView コントロール

1 列の値と各項目の横にアイコンを表示する ListView コントロール。 これにより、ユーザーは、事前に定義されたリストからプロパティの単一の文字列または整数値を選択できます。 可能な値は ListView テーブルから読み取られます。 コントロールを整数または文字列値に関連付けるには、Control テーブルの Property 列にプロパティ名を入力します。

Control テーブルの Text フィールドの内容は、ListView コントロールによって表示されません。 代わりに、このフィールドは、コントロールによって表示されるテキストのスタイルを指定し、画面レビュー ユーティリティによって使用されるコントロールの説明を含みます。 テキスト文字列のフォントとフォント スタイルを設定するには、表示される文字の文字列の先頭に {\style} または {&style} を付けます。 ここで、style は、TextStyle テーブルの TextStyle 列に記載されている識別子です。 これらのどちらも存在しないが、DefaultUIFont プロパティが有効なテキスト スタイルとして定義されている場合は、そのフォントが使用されます。 この後の情報は、コントロールの説明として画面レビュー ユーティリティによって読み取られます。 「アクセシビリティ」を参照してください。

コントロールの属性

このコントロールでは次の属性を使用できます。 イベントを使用して属性の値を変更するには、EventMapping テーブルの ControlEvent にコントロールをサブスクライブし、Attribute 列に属性の識別子を記載します。 Event 列に ControlEvent の識別子を入力します。

解説

このコントロールは、CreateWindowEx 関数を使用して、WC_LISTVIEW クラスから作成できます。 LVS_REPORT、LVS_NOCOLUMNHEADER、WS_VSCROLL、WS_HSCROLL、LVS_SHAREIMAGELISTS、LVS_SINGLESEL、LVS_SHOWSELALWAYS、WS_BORDER、および WS_TABSTOP の各スタイルがあります。 Sorted スタイル ビットがオンでない場合、コントロールには LVS_SORTASCENDING スタイルもあります。

スクリーン リーダーとの互換性を保つには、ListView コントロールを最初のアクティブ コントロールとして設定したダイアログを作成するときに、編集フィールドに属するテキスト フィールドを Dialog テーブルの最初のアクティブ なコントロールにする必要があります。 静的テキストにフォーカスを移すことができないので、ダイアログが作成されると、意図したとおりに編集フィールドに最初にフォーカスが設定されますが、こうすることでスクリーン リーダーで正しい情報が表示されるようになります。