ColumnHeader.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 van de afbeelding opgehaald of ingesteld die wordt weergegeven in de ColumnHeader.
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.ImageIndexConverter))>]
member this.ImageIndex : int with get, setPublic Property ImageIndex As IntegerWaarde van eigenschap
De index van de afbeelding die wordt weergegeven in de ColumnHeader.
- Kenmerken
Uitzonderingen
value is kleiner dan -1.
Opmerkingen
De ImageIndex eigenschap verwijst naar de index van een afbeelding die is opgegeven door de SmallImageList eigenschap van de ListView eigenschap die de ColumnHeader. De ImageIndex eigenschap retourneert -1 als er geen SmallImageList set is ingesteld op het betreffende ListViewbestand. De afbeelding die in een kolom wordt weergegeven, wordt meestal gebruikt om de status van items in de kolom aan te geven.
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.
