ListView.ListViewItemCollection.Insert Metod
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.
Infogar ett objekt i samlingen vid det angivna indexet.
Överlagringar
| Name | Description |
|---|---|
| Insert(Int32, String, String, String) |
Skapar ett nytt objekt med den angivna nyckeln, texten och bilden och lägger till det i samlingen i det angivna indexet. |
| Insert(Int32, String, String, Int32) |
Skapar ett nytt objekt med den angivna nyckeln, texten och bilden och infogar det i samlingen vid det angivna indexet. |
| Insert(Int32, String, String) |
Skapar ett nytt objekt med den angivna texten och bilden och infogar det i samlingen vid det angivna indexet. |
| Insert(Int32, ListViewItem) |
Infogar en befintlig ListViewItem i samlingen vid det angivna indexet. |
| Insert(Int32, String) |
Skapar ett nytt objekt och infogar det i samlingen vid det angivna indexet. |
| Insert(Int32, String, Int32) |
Skapar ett nytt objekt med det angivna avbildningsindexet och infogar det i samlingen vid det angivna indexet. |
Insert(Int32, String, String, String)
Skapar ett nytt objekt med den angivna nyckeln, texten och bilden och lägger till det i samlingen i det angivna indexet.
public:
virtual System::Windows::Forms::ListViewItem ^ Insert(int index, System::String ^ key, System::String ^ text, System::String ^ imageKey);
public virtual System.Windows.Forms.ListViewItem Insert(int index, string key, string text, string imageKey);
public virtual System.Windows.Forms.ListViewItem Insert(int index, string? key, string? text, string? imageKey);
abstract member Insert : int * string * string * string -> System.Windows.Forms.ListViewItem
override this.Insert : int * string * string * string -> System.Windows.Forms.ListViewItem
Public Overridable Function Insert (index As Integer, key As String, text As String, imageKey As String) As ListViewItem
Parametrar
- index
- Int32
Den nollbaserade indexplats där objektet infogas.
- text
- String
Texten i objektet.
- imageKey
- String
Nyckeln för den bild som ska visas för objektet.
Returer
Den ListViewItem som har lagts till i samlingen.
Undantag
Parametern index är mindre än 0 eller större än värdet för Count egenskapen för ListView.ListViewItemCollection.
Kommentarer
Metoden Insert anger Name egenskapen för objektet till den angivna nyckeln, så att objektet kan hämtas av dess index eller genom nyckel.
Gäller för
Insert(Int32, String, String, Int32)
Skapar ett nytt objekt med den angivna nyckeln, texten och bilden och infogar det i samlingen vid det angivna indexet.
public:
virtual System::Windows::Forms::ListViewItem ^ Insert(int index, System::String ^ key, System::String ^ text, int imageIndex);
public virtual System.Windows.Forms.ListViewItem Insert(int index, string key, string text, int imageIndex);
public virtual System.Windows.Forms.ListViewItem Insert(int index, string? key, string? text, int imageIndex);
abstract member Insert : int * string * string * int -> System.Windows.Forms.ListViewItem
override this.Insert : int * string * string * int -> System.Windows.Forms.ListViewItem
Public Overridable Function Insert (index As Integer, key As String, text As String, imageIndex As Integer) As ListViewItem
Parametrar
- index
- Int32
Den nollbaserade indexplats där objektet infogas.
- text
- String
Texten i objektet.
- imageIndex
- Int32
Indexet för bilden som ska visas för objektet.
Returer
Den ListViewItem som har lagts till i samlingen.
Undantag
Parametern index är mindre än 0 eller större än värdet för Count egenskapen för ListView.ListViewItemCollection.
Kommentarer
Metoden Insert anger Name egenskapen för objektet till den angivna nyckeln, så att objektet kan hämtas av dess index eller genom nyckel.
Gäller för
Insert(Int32, String, String)
Skapar ett nytt objekt med den angivna texten och bilden och infogar det i samlingen vid det angivna indexet.
public:
System::Windows::Forms::ListViewItem ^ Insert(int index, System::String ^ text, System::String ^ imageKey);
public System.Windows.Forms.ListViewItem Insert(int index, string text, string imageKey);
public System.Windows.Forms.ListViewItem Insert(int index, string? text, string? imageKey);
member this.Insert : int * string * string -> System.Windows.Forms.ListViewItem
Public Function Insert (index As Integer, text As String, imageKey As String) As ListViewItem
Parametrar
- index
- Int32
Den nollbaserade indexplats där objektet infogas.
- text
- String
Texten i ListViewItem.
- imageKey
- String
Nyckeln för den bild som ska visas för objektet.
Returer
Den ListViewItem som har lagts till i samlingen.
Undantag
Parametern index är mindre än 0 eller större än värdet för Count egenskapen för ListView.ListViewItemCollection.
Gäller för
Insert(Int32, ListViewItem)
Infogar en befintlig ListViewItem i samlingen vid det angivna indexet.
public:
System::Windows::Forms::ListViewItem ^ Insert(int index, System::Windows::Forms::ListViewItem ^ item);
public System.Windows.Forms.ListViewItem Insert(int index, System.Windows.Forms.ListViewItem item);
member this.Insert : int * System.Windows.Forms.ListViewItem -> System.Windows.Forms.ListViewItem
Public Function Insert (index As Integer, item As ListViewItem) As ListViewItem
Parametrar
- index
- Int32
Den nollbaserade indexplats där objektet infogas.
- item
- ListViewItem
Det ListViewItem som representerar det objekt som ska infogas.
Returer
Det ListViewItem som infogades i samlingen.
Undantag
Parametern index är mindre än 0 eller större än värdet för Count egenskapen för ListView.ListViewItemCollection.
Kommentarer
Med den Insert här versionen av metoden kan du infoga en befintlig ListViewItem vid en viss position i ListView.ListViewItemCollection.
Note
Om egenskapen ListView.Sorting är inställd på ett annat värde än SortOrder.None eller om ListViewItemSorter egenskapen har angetts sorteras listan efter att objektet har infogats.
Om du vill lägga till ett objekt utan att ange en specifik position i samlingen för att lägga till objektet använder du Add metoden . Om du vill lägga till en matris med objekt i samlingen använder du AddRange metoden . Du kan använda den här metoden om du vill infoga ett nytt objekt i en befintlig samling objekt.
Se även
Gäller för
Insert(Int32, String)
Skapar ett nytt objekt och infogar det i samlingen vid det angivna indexet.
public:
System::Windows::Forms::ListViewItem ^ Insert(int index, System::String ^ text);
public System.Windows.Forms.ListViewItem Insert(int index, string text);
public System.Windows.Forms.ListViewItem Insert(int index, string? text);
member this.Insert : int * string -> System.Windows.Forms.ListViewItem
Public Function Insert (index As Integer, text As String) As ListViewItem
Parametrar
- index
- Int32
Den nollbaserade indexplats där objektet infogas.
- text
- String
Texten som ska visas för objektet.
Returer
Det ListViewItem som infogades i samlingen.
Undantag
Parametern index är mindre än 0 eller större än värdet för Count egenskapen för ListView.ListViewItemCollection.
Kommentarer
Med den Insert här versionen av metoden kan du infoga ett nytt objekt på en specifik plats i ListView.ListViewItemCollection. Texten som anges i parametern text används för att skapa en ny ListViewItem som sedan infogas på den ListView.ListViewItemCollection angivna platsen.
Note
Om egenskapen ListView.Sorting är inställd på ett annat värde än SortOrder.None eller om ListViewItemSorter egenskapen har angetts sorteras listan efter att objektet har infogats.
Om du vill lägga till ett objekt utan att ange en specifik position i samlingen använder du Add metoden . Om du vill lägga till en matris med objekt i samlingen använder du AddRange metoden . Du kan använda den här metoden om du vill infoga ett nytt objekt i en befintlig samling objekt.
Se även
Gäller för
Insert(Int32, String, Int32)
Skapar ett nytt objekt med det angivna avbildningsindexet och infogar det i samlingen vid det angivna indexet.
public:
System::Windows::Forms::ListViewItem ^ Insert(int index, System::String ^ text, int imageIndex);
public System.Windows.Forms.ListViewItem Insert(int index, string text, int imageIndex);
public System.Windows.Forms.ListViewItem Insert(int index, string? text, int imageIndex);
member this.Insert : int * string * int -> System.Windows.Forms.ListViewItem
Public Function Insert (index As Integer, text As String, imageIndex As Integer) As ListViewItem
Parametrar
- index
- Int32
Den nollbaserade indexplats där objektet infogas.
- text
- String
Texten som ska visas för objektet.
- imageIndex
- Int32
Indexet för bilden som ska visas för objektet.
Returer
Det ListViewItem som infogades i samlingen.
Undantag
Parametern index är mindre än 0 eller större än värdet för Count egenskapen för ListView.ListViewItemCollection.
Kommentarer
Med den Insert här versionen av metoden kan du infoga ett nytt objekt på en specifik plats i ListView.ListViewItemCollection. Texten som anges i parametern text används för att skapa en ny ListViewItem som sedan infogas på den ListView.ListViewItemCollection angivna platsen.
Note
Om egenskapen ListView.Sorting är inställd på ett annat värde än SortOrder.None eller om ListViewItemSorter egenskapen har angetts sorteras listan efter att objektet har infogats.
Du kan också använda den Insert här versionen av metoden för att ange en bild för objektet genom att skicka indexet för ImageList de ListView.LargeImageList tilldelade egenskaperna och ListView.SmallImageList till parameternimageIndex. (Egenskaperna och ListView.LargeImageList använder vanligtvis ListView.SmallImageList samma indexpositioner för att visa relaterade bilder.) Om du inte vill ange ett bildindex för objektet använder du den andra versionen av Insert metoden som accepterar en sträng som en parameter.
Om du vill lägga till ett objekt utan att ange en specifik position i samlingen använder du Add metoden . Om du vill lägga till en matris med objekt i samlingen använder du AddRange metoden .