ListViewItem.ImageIndex プロパティ

定義

項目に対して表示されるイメージのインデックスを取得または設定します。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))]
public int ImageIndex { get; set; }
[System.ComponentModel.TypeConverter(typeof(System.Windows.Forms.ImageIndexConverter))]
public int ImageIndex { get; set; }
[<System.ComponentModel.TypeConverter(typeof(System.Windows.Forms.NoneExcludedImageIndexConverter))>]
member this.ImageIndex : int with get, set
[<System.ComponentModel.TypeConverter(typeof(System.Windows.Forms.ImageIndexConverter))>]
member this.ImageIndex : int with get, set
Public Property ImageIndex As Integer

プロパティ値

Int32

項目に対して表示される 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. プロパティがに設定されている場合は、プロパティで指定されたが使用されます。 View LargeIcon それ以外の場合は、 ImageList LargeImageList ImageList プロパティで指定されたが使用され SmallImageList ます。If 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. で指定されたで定義されているイメージは、 ImageList SmallImageList ImageList プロパティで指定されたのイメージと同じインデックス位置にある必要があり LargeImageList ます。The 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 プロパティに対して1つのインデックス値を設定できます。これにより、 ImageIndex コントロールのプロパティの値に関係なく、適切なイメージが表示され View ListView ます。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. ImageKeyプロパティと ImageIndex プロパティは相互に排他的です。つまり、設定されている場合、もう一方は無視されます。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 ("").

適用対象

こちらもご覧ください