ListViewItem.ImageIndex Eigenschap
Definitie
Belangrijk
Bepaalde informatie heeft betrekking op een voorlopige productversie die aanzienlijk kan worden gewijzigd voordat deze wordt uitgebracht. Microsoft biedt geen enkele expliciete of impliciete garanties met betrekking tot de informatie die hier wordt verstrekt.
Hiermee wordt de index opgehaald of ingesteld van de afbeelding die voor het item wordt weergegeven.
public:
property int ImageIndex { int get(); void set(int value); };[System.ComponentModel.TypeConverter(typeof(System.Windows.Forms.ImageIndexConverter))]
public int ImageIndex { get; set; }[System.ComponentModel.TypeConverter(typeof(System.Windows.Forms.NoneExcludedImageIndexConverter))]
public int ImageIndex { get; set; }[<System.ComponentModel.TypeConverter(typeof(System.Windows.Forms.ImageIndexConverter))>]
member this.ImageIndex : int with get, set[<System.ComponentModel.TypeConverter(typeof(System.Windows.Forms.NoneExcludedImageIndexConverter))>]
member this.ImageIndex : int with get, setPublic Property ImageIndex As IntegerWaarde van eigenschap
De op nul gebaseerde index van de afbeelding in de ImageList afbeelding die voor het item wordt weergegeven. De standaardwaarde is -1.
- Kenmerken
Uitzonderingen
value is kleiner dan -1.
Opmerkingen
De waarde van deze eigenschap is afhankelijk van de waarde van de ImageList eigenschap. Afhankelijk van de huidige waarde van de eigenschap van het View besturingselement dat aan het ListView item is gekoppeld, kan het ImageList door het item gebruikte waarde zijn opgegeven in de LargeImageList eigenschap of de SmallImageList eigenschap van het ListView besturingselement. Als de View eigenschap is ingesteld op LargeIcon, wordt de ImageList opgegeven in de LargeImageList eigenschap gebruikt; anders wordt de ImageList opgegeven in de SmallImageList eigenschap gebruikt. De afbeeldingen die zijn gedefinieerd in de ImageList opgegeven eigenschap SmallImageList , moeten dezelfde indexposities hebben als de afbeeldingen in de ImageListLargeImageList opgegeven eigenschap. Als de indexposities voor beide ImageList besturingselementen hetzelfde zijn, kunt u één indexwaarde voor de ImageIndex eigenschap instellen en wordt de juiste afbeelding weergegeven, ongeacht de waarde van de View eigenschap van het ListView besturingselement.
ImageKey en ImageIndex wederzijds uitsluiten, wat betekent dat als de ene is ingesteld, de andere wordt ingesteld op een ongeldige waarde en genegeerd. Als u de ImageKey eigenschap instelt, wordt de ImageIndex eigenschap automatisch ingesteld op -1. Als u de eigenschap instelt, wordt de ImageIndexImageKey eigenschap ook automatisch ingesteld op een lege tekenreeks ("").
Als de ImageList eigenschapswaarde wordt gewijzigd nullin , retourneert de eigenschap de ImageIndex standaardwaarde -1. De toegewezen ImageIndex waarde wordt echter intern bewaard en gebruikt wanneer een ander ImageList object aan de ImageList eigenschap wordt toegewezen. Als de nieuwe ImageList die aan de ImageList eigenschap is toegewezen een ImageList.ImageCollection.Count eigenschapswaarde heeft die kleiner is dan of gelijk is aan de waarde die is toegewezen aan de ImageIndex eigenschap min één (om rekening te houden met de verzameling als een op nul gebaseerde index), wordt de ImageIndex eigenschapswaarde aangepast aan een waarde die kleiner is dan de Count eigenschapswaarde.
Denk bijvoorbeeld aan een knopbesturingselement met ImageList drie afbeeldingen en waarvan de ImageIndex eigenschap is ingesteld op 2. Als er ImageList slechts twee afbeeldingen aan de knop zijn toegewezen, wordt de ImageIndex waarde gewijzigd in 1.
