ListViewItem.ImageIndex ListViewItem.ImageIndex ListViewItem.ImageIndex ListViewItem.ImageIndex Property

定義

項目に対して表示されるイメージのインデックスを取得または設定します。Gets or sets the index of the image that is displayed for the item.

public:
 property int ImageIndex { int get(); void set(int value); };
[System.ComponentModel.TypeConverter(typeof(System.Windows.Forms.NoneExcludedImageIndexConverter))]
[System.ComponentModel.TypeConverter(typeof(System.Windows.Forms.ImageIndexConverter))]
public int ImageIndex { get; set; }
member this.ImageIndex : int with get, set
Public Property ImageIndex As Integer

プロパティ値

項目に対して表示される ImageList のイメージの 0 から始まるインデックス。The zero-based index of the image in the ImageList that is displayed for the item. 既定値は -1 です。The default is -1.

例外

指定された値が -1 未満です。The value specified is less than -1.

注釈

このプロパティの値は、 ImageListプロパティの値によって異なります。The value of this property depends on the value of the ImageList property. 項目に関連付けられてViewいるListViewコントロールのプロパティの現在の値に応じImageListて、項目によって使用されるはLargeImageList 、プロパティまたSmallImageListはのListViewプロパティで指定されたものである可能性があります。コントロール。Depending on the current value of the View property of the ListView control associated with the item, the ImageList used by the item could be one specified in the LargeImageList property or the SmallImageList property of the ListView control. LargeIcon SmallImageList ImageList LargeImageListプロパティがに設定されている場合は、プロパティで指定されたが使用されます。それ以外の場合は、プロパティで指定されたが使用されます。ImageList ViewIf the View property is set to LargeIcon, the ImageList specified in the LargeImageList property is used; otherwise, the ImageList specified in the SmallImageList property is used. で指定されたでLargeImageList定義されImageListているイメージは、プロパティで指定されたのイメージと同じインデックス位置にある必要があります。SmallImageList ImageListThe images defined in the ImageList specified in the SmallImageList should have the same index positions as the images in the ImageList specified in the LargeImageList property. ImageListインデックス位置が両方のコントロールで同じである場合は、 ImageIndexプロパティに対して1つのインデックス値を設定できます。これにより、 ListViewコントロールのViewプロパティの値に関係なく、適切なイメージが表示されます。If the index positions are the same for both ImageList controls, you can set a single index value for the ImageIndex property and the appropriate image will be displayed regardless of the value of the View property of the ListView control. プロパティImageKeyImageIndexプロパティは相互に排他的です。つまり、設定されている場合、もう一方は無視されます。The ImageKey and ImageIndex properties are mutually exclusive, meaning if one is set, the other is ignored. さらに、 ImageKeyプロパティImageIndexを設定すると、プロパティは自動的に-1 に設定されます。Furthermore, if you set the ImageKey property, the ImageIndex property is automatically set to -1. また、 ImageIndexプロパティを設定した場合はImageKey 、が自動的に空の文字列 ("") に設定されます。Alternatively, if you set the ImageIndex property, the ImageKey is automatically set to an empty string ("").

適用対象

こちらもご覧ください