ListView コントロール
各項目の横にアイコンが付いた値の単一列を表示する ListView コントロール。 これにより、ユーザーは、事前に定義されたリストからプロパティの単一の文字列または整数値を選択できます。 指定できる値は、ListView テーブルから読み取られます。 コントロールを整数または文字列値に関連付けるには、Control テーブルの Property 列にプロパティの名前を入力します。
コントロール テーブル の [テキスト] フィールドの内容は、ListView コントロールには表示されません。 代わりに、このフィールドは、コントロールによって表示されるテキストのスタイルを指定し、画面レビュー ユーティリティで使用されるコントロールの説明を含みます。 テキスト文字列のフォントとフォント スタイルを設定するには、表示される文字の文字列の先頭に {\style} または {&スタイル} を付けます。 ここで、style は、TextStyle テーブルの TextStyle 列に一覧表示される識別子です。 どちらも存在しないが、DefaultUIFont プロパティが有効なテキスト スタイルとして定義されている場合は、そのフォントが使用されます。 この後の情報は、コントロールの説明として画面レビュー ユーティリティによって読み取られます。 アクセシビリティ を参照してください。
コントロール属性
このコントロールでは、次の属性を使用できます。 イベントを使用して属性の値を変更するには、EventMapping テーブルの ControlEvent コントロールをサブスクライブし、[属性] 列に属性の識別子を一覧表示します。 [イベント] 列に ControlEvent の識別子を入力します。
属性識別子 | 16 進数ビット | 形容 |
---|---|---|
IndirectPropertyName | これは、コントロールに関連付けられている間接プロパティの名前です。 間接属性ビットが設定されている場合、コントロールは、この名前を持つプロパティの値を表示または変更します。 間接属性ビットが設定されている場合、この名前は、Control テーブルの [プロパティ] 列に表示されるプロパティの値。 | |
位置 | ダイアログ ボックス内のコントロールの位置。 コントロールの左隅のコントロールの幅、高さ、および座標を、Control テーブルの [幅]、[高さ]、[X]、および [Y] 列に入力。 長さと距離 インストーラー ユニットを使用します。 |
|
PropertyName | これは、このコントロールに関連付けられているプロパティの名前です。 Indirect 属性ビットが設定されていない場合、コントロールは、この名前を持つプロパティの値を表示または変更します。 この属性は、コントロール テーブルの [プロパティ] 列で指定します。 | |
PropertyValue | このコントロールによって表示または変更されたプロパティの現在の値。 間接属性ビットが設定されていない場合、これは PropertyName の値です。 Indirect 属性ビットが設定されている場合、これは IndirectPropertyName の値です。 属性が変更されると、コントロールには新しい値が反映されます。 | |
テキスト | スクリーン リーダーにテキストを表示するには、コントロール テーブルの [テキスト] 列にテキスト入力します。 アクセシビリティ を参照してください。 | |
表示 | 0x00000000 0x00000001 |
非表示のコントロール。 表示コントロール。 コントロールを作成時に表示または非表示にするには、コントロール テーブルの の [属性] 列のビット ワードにこのビットを含めます。 ControlCondition テーブルを使用して、コントロールを非表示または表示することもできます。 |
Enabled | 0x00000000 0x00000002 |
無効な状態のコントロール。 有効な状態での制御。 作成時にコントロールを有効にするには、コントロール の [属性] 列のビット ワードにこのビットを含めます。 ControlCondition テーブルを使用して、コントロールを有効または無効にすることもできます。 |
沈没 | 0x00000000 0x00000004 |
既定の表示スタイルを表示します。 コントロールを 3-D の見た目で表示します。 これらのビットは、コントロール テーブルの [属性] 列のビット ワード含めます。 |
間接 の | 0x00000000 0x00000008 |
コントロールは、コントロール テーブルの Property 列にプロパティの値を表示または変更します。 コントロールは、コントロール テーブルの Property 列に表示される識別子を持つプロパティの値を表示または変更します。 このコントロールに関連付けられているプロパティが間接的に参照されているかどうかを判断します。 |
整数 の | 0x00000000 0x00000010 |
コントロールに関連付けられているプロパティは文字列値です。 コントロールに関連付けられているプロパティは整数値です。 コントロールの作成時にこの属性を設定するには、コントロール テーブルの の Attributes 列のビット ワードにこのビットを含めます。 |
RTLRO を する | 0x00000000 0x00000020 |
コントロール内のテキストは、左から右の読み取り順序で表示されます。 コントロール内のテキストは、右から左の読み取り順序で表示されます。 |
RightAligned を する | 0x00000000 0x00000040 |
コントロール内のテキストは左に配置されます。 コントロール内のテキストが右側に配置されます。 |
LeftScroll を する | 0x00000000 0x00000080 |
スクロール バーはコントロールの右側にあります。 スクロール バーはコントロールの左側にあります。 |
BiDi | 0x000000E0 | この値は、RTLRO、rightAligned 、および LeftScroll 属性の組み合わせ 設定します。 |
並べ替えられた を する | 0x00000000 0x00010000 |
アルファベット順に表示される項目。
ListView テーブルで指定された順序で表示される項目。 ListView テーブルの Order 列で指定された順序で項目を表示するには、[属性] 列のビット ワードにこのビットを含めます。 |
FixedSize | 0x00000000 0x00100000 |
コントロールに合わせてアイコンイメージを拡大します。 コントロール内のアイコンイメージをトリミングまたは中央に表示します。 このビットは、コントロール テーブルの [属性] 列のビット ワード含めます。 |
IconSize | 0x00000000 0x00200000 0x00400000 0x00600000 |
最初のイメージを読み込みます。 最初の 16 x 16 イメージを読み込みます。 最初の 32 x 32 イメージを読み込みます。 最初の 48 x 48 イメージを読み込みます。 アイコン ファイルには、同じアイコンの異なるサイズの画像を含めることができます。 コントロール テーブルの [属性] 列に適切なビット ワードの値を含めます これらのビットが設定されていない場合、インストーラーは FixedSize 属性を無視し、コントロールの四角形に合わせてイメージが拡大されます。 IconSize ビットと FixedSize ビットの両方が設定されている場合、コントロールよりも小さいイメージが中央に配置され、イメージが縮小されて収まるコントロールよりも大きくなります。 |
備考
このコントロールは、CreateWindowEx 関数を使用して、WC_LISTVIEW クラスから作成できます。 これには、LVS_REPORT、LVS_NOCOLUMNHEADER、WS_VSCROLL、WS_HSCROLL、LVS_SHAREIMAGELISTS、LVS_SINGLESEL、LVS_SHOWSELALWAYS、WS_BORDER、および WS_TABSTOP スタイルがあります。 並べ替えられたスタイル ビットがオンでない場合、コントロールには LVS_SORTASCENDING スタイルもあります。
スクリーン リーダーとの互換性のために、ListView コントロールを最初のアクティブ コントロールとしてダイアログを作成する場合は、編集フィールドに属するテキスト フィールドを Dialog テーブルの最初のアクティブ なコントロールにする必要があります。 静的テキストはフォーカスを取ることができないので、ダイアログが作成されると、編集フィールドは最初は意図したとおりにフォーカスを持ちますが、これによりスクリーン リーダーに正しい情報が表示されるようになります。