ListView.StateImageList プロパティ


コントロールのアプリケーション定義の状態に関連付けられた ImageList を取得または設定します。Gets or sets the ImageList associated with application-defined states in the control.

 property System::Windows::Forms::ImageList ^ StateImageList { System::Windows::Forms::ImageList ^ get(); void set(System::Windows::Forms::ImageList ^ value); };
public System.Windows.Forms.ImageList StateImageList { get; set; }
member this.StateImageList : System.Windows.Forms.ImageList with get, set
Public Property StateImageList As ImageList



項目のアプリケーション定義の状態を示すのに使用される、状態のイメージのセットを格納した ImageListAn ImageList that contains a set of state images that can be used to indicate an application-defined state of an item. 既定値は、null です。The default is null.


プロパティでは、 StateImageList ImageList コントロール内の項目のアプリケーション固有の状態を表すために使用するイメージを格納するを指定でき ListView ます。The StateImageList property allows you to specify an ImageList that contains images to use to represent an application-specific state of an item in a ListView control. 状態イメージは、項目のアイコンの左側に表示されます。State images are displayed to the left of an icon for the item. チェックボックスやチェックボックスをオフにした状態画像を使用して、アプリケーション定義の項目の状態を示すことができます。You can use state images, such as checked and unchecked check boxes, to indicate application-defined item states. 状態イメージは、コントロールのすべてのビューに表示され ListView ます。State images are visible in all views of the ListView control.

ImageListプロパティにが指定されていて、プロパティがに設定されている場合、インデックス位置が0になっている StateImageList イメージと内の CheckBoxes 1 の true 画像が、 ImageList チェックボックスの代わりに表示されます。If an ImageList is specified in the StateImageList property and the CheckBoxes property is set to true, the images at index positions 0 and 1 in the ImageList are displayed instead of the check box. [インデックス位置 0] のイメージは [unchecked] チェックボックスの代わりに表示され、[インデックス位置 1] のイメージはチェックボックスの代わりに表示されます。The image at index position 0 is displayed instead of the unchecked check box, and the image at index position 1 is displayed instead of the checked check box.