ListViewItem.ImageIndex Egenskap
Definition
Viktigt
En del information gäller för förhandsversionen av en produkt och kan komma att ändras avsevärt innan produkten blir allmänt tillgänglig. Microsoft lämnar inga garantier, uttryckliga eller underförstådda, avseende informationen som visas här.
Hämtar eller anger indexet för den bild som visas för objektet.
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 IntegerEgenskapsvärde
Det nollbaserade indexet för bilden i ImageList som visas för objektet. Standardvärdet är -1.
- Attribut
Undantag
value är mindre än -1.
Kommentarer
Värdet för den här egenskapen beror på värdet för ImageList egenskapen. Beroende på det aktuella värdet för View egenskapen för kontrollen ListView som är associerad med objektet kan ImageList det som används av objektet vara ett som anges i LargeImageList egenskapen eller SmallImageList egenskapen för ListView kontrollen. Om egenskapen View är inställd LargeIconpå används den ImageList angivna egenskapen LargeImageList . Annars används den ImageList angivna egenskapen SmallImageList . Bilderna som definierats i den ImageList angivna egenskapen SmallImageList ska ha samma indexpositioner som bilderna i den ImageList angivna egenskapen LargeImageList . Om indexpositionerna är desamma för båda ImageList kontrollerna kan du ange ett enda indexvärde för ImageIndex egenskapen och lämplig bild visas oavsett värdet View för kontrollens ListView egenskap.
ImageKey och ImageIndex är ömsesidigt uteslutande, vilket innebär att om det ena anges, anges det andra till ett ogiltigt värde och ignoreras. Om du anger egenskapen ImageKey anges egenskapen ImageIndex automatiskt till -1. Om du anger ImageIndex egenskapen ImageKey anges den också automatiskt till en tom sträng ("").
Om egenskapsvärdet ImageList ändras till nullImageIndex returnerar egenskapen standardvärdet -1. Det tilldelade ImageIndex värdet behålls dock internt och används när ett annat ImageList objekt tilldelas egenskapen ImageList . Om den nya ImageList tilldelade ImageList egenskapen har ett ImageList.ImageCollection.Count egenskapsvärde som är mindre än eller lika med det värde som tilldelats ImageIndex egenskapen minus ett (för att ta hänsyn till att samlingen är ett nollbaserat index) ImageIndex justeras egenskapsvärdet till ett mindre än egenskapsvärdet Count .
Överväg till exempel en knappkontroll vars ImageList tre bilder och vars ImageIndex egenskap är inställd på 2. Om en ny ImageList som bara har två bilder tilldelas knappen ImageIndex ändras värdet till 1.
