Freigeben über


ListView.ColumnHeaderCollection.Insert Methode

Definition

Fügt einer Auflistung einen Spaltenkopf am angegebenen Index hinzu.

Überlädt

Insert(Int32, String, String, Int32, HorizontalAlignment, String)

Erstellt einen neuen Spaltenheader mit dem angegebenen ausgerichteten Text, dem angegebenen Schlüssel, der angegebenen Breite und dem angegebenen Bildschlüssel und fügt den Header am angegebenen Index in die Auflistung ein.

Insert(Int32, String, String, Int32, HorizontalAlignment, Int32)

Erstellt einen neuen Spaltenheader mit dem angegebenen ausgerichteten Text, dem angegebenen Schlüssel, der angegebenen Breite und dem angegebenen Bildindex und fügt den Header am angegebenen Index in die Auflistung ein.

Insert(Int32, String, Int32, HorizontalAlignment)

Erstellt einen neuen Spaltenkopf und fügt ihn am angegebenen Index in die Auflistung ein.

Insert(Int32, String, String, Int32)

Erstellt einen neuen Spaltenheader mit dem angegebenen Text, dem angegebenen Schlüssel und der angegebenen Breite und fügt den Header am angegebenen Index in die Auflistung ein.

Insert(Int32, String, String)

Erstellt einen neuen Spaltenheader mit dem angegebenen Text und dem angegebenen Schlüssel und fügt den Header am angegebenen Index in die Auflistung ein.

Insert(Int32, String, Int32)

Erstellt einen neuen Spaltenheader mit dem angegebenen Text und der ursprünglichen Breite und fügt den Header am angegebenen Index in die Auflistung ein.

Insert(Int32, ColumnHeader)

Fügt einer Auflistung einen vorhandenen Spaltenkopf am angegebenen Index hinzu.

Insert(Int32, String)

Erstellt einen neuen Spaltenheader mit dem angegebenen Text und fügt den Header am angegebenen Index in die Auflistung ein.

Insert(Int32, String, String, Int32, HorizontalAlignment, String)

Erstellt einen neuen Spaltenheader mit dem angegebenen ausgerichteten Text, dem angegebenen Schlüssel, der angegebenen Breite und dem angegebenen Bildschlüssel und fügt den Header am angegebenen Index in die Auflistung ein.

public:
 void Insert(int index, System::String ^ key, System::String ^ text, int width, System::Windows::Forms::HorizontalAlignment textAlign, System::String ^ imageKey);
public void Insert (int index, string key, string text, int width, System.Windows.Forms.HorizontalAlignment textAlign, string imageKey);
member this.Insert : int * string * string * int * System.Windows.Forms.HorizontalAlignment * string -> unit
Public Sub Insert (index As Integer, key As String, text As String, width As Integer, textAlign As HorizontalAlignment, imageKey As String)

Parameter

index
Int32

Die nullbasierte Indexposition, an der der Spaltenkopf eingefügt wird.

key
String

Der Name des Spaltenheaders.

text
String

Der im Spaltenkopf anzuzeigende Text

width
Int32

Die ursprüngliche Breite des Spaltenheaders in Pixel.

textAlign
HorizontalAlignment

Einer der HorizontalAlignment-Werte.

imageKey
String

Der Schlüssel des im Spaltenheader anzuzeigenden Bilds.

Hinweise

Verwenden Sie die Add Methode, um eine Spaltenüberschrift hinzuzufügen, ohne eine Position in der Auflistung anzugeben. Wenn Sie der Auflistung ein Array mit Spaltenüberschriften hinzufügen möchten, verwenden Sie die AddRange Methode.

Die Name Eigenschaft entspricht dem Schlüssel für eine Spalte in der ListView.ColumnHeaderCollection.

Gilt für

Insert(Int32, String, String, Int32, HorizontalAlignment, Int32)

Erstellt einen neuen Spaltenheader mit dem angegebenen ausgerichteten Text, dem angegebenen Schlüssel, der angegebenen Breite und dem angegebenen Bildindex und fügt den Header am angegebenen Index in die Auflistung ein.

public:
 void Insert(int index, System::String ^ key, System::String ^ text, int width, System::Windows::Forms::HorizontalAlignment textAlign, int imageIndex);
public void Insert (int index, string key, string text, int width, System.Windows.Forms.HorizontalAlignment textAlign, int imageIndex);
member this.Insert : int * string * string * int * System.Windows.Forms.HorizontalAlignment * int -> unit
Public Sub Insert (index As Integer, key As String, text As String, width As Integer, textAlign As HorizontalAlignment, imageIndex As Integer)

Parameter

index
Int32

Die nullbasierte Indexposition, an der der Spaltenkopf eingefügt wird.

key
String

Der Name des Spaltenheaders.

text
String

Der im Spaltenkopf anzuzeigende Text

width
Int32

Die ursprüngliche Breite des Spaltenheaders in Pixel.

textAlign
HorizontalAlignment

Einer der HorizontalAlignment-Werte.

imageIndex
Int32

Der Index des im Spaltenheader anzuzeigenden Bilds.

Hinweise

Verwenden Sie die Add Methode, um eine Spaltenüberschrift hinzuzufügen, ohne eine Position in der Auflistung anzugeben. Wenn Sie einer Auflistung ein Array von Spaltenüberschriften hinzufügen möchten, verwenden Sie die AddRange Methode.

Die Name Eigenschaft entspricht dem Schlüssel für eine Spalte in der ListView.ColumnHeaderCollection.

Gilt für

Insert(Int32, String, Int32, HorizontalAlignment)

Erstellt einen neuen Spaltenkopf und fügt ihn am angegebenen Index in die Auflistung ein.

public:
 void Insert(int index, System::String ^ str, int width, System::Windows::Forms::HorizontalAlignment textAlign);
public:
 void Insert(int index, System::String ^ text, int width, System::Windows::Forms::HorizontalAlignment textAlign);
public void Insert (int index, string str, int width, System.Windows.Forms.HorizontalAlignment textAlign);
public void Insert (int index, string text, int width, System.Windows.Forms.HorizontalAlignment textAlign);
member this.Insert : int * string * int * System.Windows.Forms.HorizontalAlignment -> unit
member this.Insert : int * string * int * System.Windows.Forms.HorizontalAlignment -> unit
Public Sub Insert (index As Integer, str As String, width As Integer, textAlign As HorizontalAlignment)
Public Sub Insert (index As Integer, text As String, width As Integer, textAlign As HorizontalAlignment)

Parameter

index
Int32

Die nullbasierte Indexposition, an der der Spaltenkopf eingefügt wird.

strtext
String

Der im Spaltenkopf anzuzeigende Text

width
Int32

Die Ausgangsbreite des Spaltenkopfes. Legen Sie den Wert zur automatischen Anpassung des Spaltenkopfes an den breitesten Unterelementtext der Spalte auf -1 fest. Wenn die Breite automatisch auf die Textbreite des Spaltenkopfes festgelegt werden soll, legen Sie den Wert auf -2 fest.

textAlign
HorizontalAlignment

Einer der HorizontalAlignment-Werte.

Ausnahmen

index ist kleiner als 0 (null) bzw. größer oder gleich dem Wert der Count-Eigenschaft der ListView.ColumnHeaderCollection.

Hinweise

Diese Version der Insert Methode ermöglicht es Ihnen, eine neue ColumnHeader mit bestimmten Spaltenüberschrifttext, Breite und Textausrichtungseinstellung zu erstellen und an einer bestimmten Position in der ListView.ColumnHeaderCollection. Sie können diese Methode verwenden, wenn Sie eine neue Spaltenüberschrift in eine vorhandene Auflistung von Spaltenüberschriften einfügen möchten. Wenn Sie ein vorhandenes ColumnHeader Objekt verwenden und an einer bestimmten Position in der Auflistung einfügen möchten, verwenden Sie die andere Version der Insert Methode. Verwenden Sie die Add Methode, um eine Spaltenüberschrift hinzuzufügen, ohne eine bestimmte Position in der Auflistung anzugeben. Wenn Sie einer Auflistung ein Array von Spaltenüberschriften hinzufügen möchten, verwenden Sie die AddRange Methode.

Siehe auch

Gilt für

Insert(Int32, String, String, Int32)

Erstellt einen neuen Spaltenheader mit dem angegebenen Text, dem angegebenen Schlüssel und der angegebenen Breite und fügt den Header am angegebenen Index in die Auflistung ein.

public:
 void Insert(int index, System::String ^ key, System::String ^ text, int width);
public void Insert (int index, string key, string text, int width);
member this.Insert : int * string * string * int -> unit
Public Sub Insert (index As Integer, key As String, text As String, width As Integer)

Parameter

index
Int32

Die nullbasierte Indexposition, an der der Spaltenkopf eingefügt wird.

key
String

Der Name des Spaltenheaders.

text
String

Der im Spaltenkopf anzuzeigende Text

width
Int32

Die ursprüngliche Breite des Spaltenheaders in Pixel.

Hinweise

Verwenden Sie die Add Methode, um eine Spaltenüberschrift hinzuzufügen, ohne eine Position in der Auflistung anzugeben. Wenn Sie einer Auflistung ein Array von Spaltenüberschriften hinzufügen möchten, verwenden Sie die AddRange Methode.

Die Name Eigenschaft entspricht dem Schlüssel für eine Spalte in der ListView.ColumnHeaderCollection.

Gilt für

Insert(Int32, String, String)

Erstellt einen neuen Spaltenheader mit dem angegebenen Text und dem angegebenen Schlüssel und fügt den Header am angegebenen Index in die Auflistung ein.

public:
 void Insert(int index, System::String ^ key, System::String ^ text);
public void Insert (int index, string key, string text);
member this.Insert : int * string * string -> unit
Public Sub Insert (index As Integer, key As String, text As String)

Parameter

index
Int32

Die nullbasierte Indexposition, an der der Spaltenkopf eingefügt wird.

key
String

Der Name des Spaltenheaders.

text
String

Der im Spaltenkopf anzuzeigende Text

Hinweise

Verwenden Sie die Add Methode, um eine Spaltenüberschrift hinzuzufügen, ohne eine Position in der Auflistung anzugeben. Wenn Sie einer Auflistung ein Array von Spaltenüberschriften hinzufügen möchten, verwenden Sie die AddRange Methode.

Die Name Eigenschaft entspricht dem Schlüssel für eine Spalte in der ListView.ColumnHeaderCollection.

Gilt für

Insert(Int32, String, Int32)

Erstellt einen neuen Spaltenheader mit dem angegebenen Text und der ursprünglichen Breite und fügt den Header am angegebenen Index in die Auflistung ein.

public:
 void Insert(int index, System::String ^ text, int width);
public void Insert (int index, string text, int width);
member this.Insert : int * string * int -> unit
Public Sub Insert (index As Integer, text As String, width As Integer)

Parameter

index
Int32

Die nullbasierte Indexposition, an der der Spaltenkopf eingefügt wird.

text
String

Der im Spaltenkopf anzuzeigende Text

width
Int32

Die ursprüngliche Breite des Spaltenheaders in Pixel.

Hinweise

Verwenden Sie die Add Methode, um eine Spaltenüberschrift hinzuzufügen, ohne eine Position in der Auflistung anzugeben. Wenn Sie einer Auflistung ein Array von Spaltenüberschriften hinzufügen möchten, verwenden Sie die AddRange Methode.

Gilt für

Insert(Int32, ColumnHeader)

Fügt einer Auflistung einen vorhandenen Spaltenkopf am angegebenen Index hinzu.

public:
 void Insert(int index, System::Windows::Forms::ColumnHeader ^ value);
public void Insert (int index, System.Windows.Forms.ColumnHeader value);
member this.Insert : int * System.Windows.Forms.ColumnHeader -> unit
Public Sub Insert (index As Integer, value As ColumnHeader)

Parameter

index
Int32

Die nullbasierte Indexposition, an der der Spaltenkopf eingefügt wird.

value
ColumnHeader

Die in die Auflistung einzufügende ColumnHeader-Klasse.

Ausnahmen

index ist kleiner als 0 (null) bzw. größer oder gleich dem Wert der Count-Eigenschaft der ListView.ColumnHeaderCollection.

Hinweise

Diese Version der Insert Methode ermöglicht es Ihnen, ein vorhandenes ColumnHeader Objekt an einer bestimmten Position in das ListView.ColumnHeaderCollectionObjekt einzufügen.

Wenn Sie ein neues ColumnHeader erstellen und an einer bestimmten Position in der Auflistung einfügen möchten, verwenden Sie die andere Version der Insert Methode. Verwenden Sie die Add Methode, um eine Spaltenüberschrift hinzuzufügen, ohne eine bestimmte Position in der Auflistung anzugeben. Wenn Sie einer Auflistung ein Array von Spaltenüberschriften hinzufügen möchten, verwenden Sie die AddRange Methode.

Siehe auch

Gilt für

Insert(Int32, String)

Erstellt einen neuen Spaltenheader mit dem angegebenen Text und fügt den Header am angegebenen Index in die Auflistung ein.

public:
 void Insert(int index, System::String ^ text);
public void Insert (int index, string text);
member this.Insert : int * string -> unit
Public Sub Insert (index As Integer, text As String)

Parameter

index
Int32

Die nullbasierte Indexposition, an der der Spaltenkopf eingefügt wird.

text
String

Der im Spaltenkopf anzuzeigende Text

Ausnahmen

index ist kleiner als 0 (null) bzw. größer oder gleich dem Wert der Count-Eigenschaft der ListView.ColumnHeaderCollection.

Hinweise

Verwenden Sie die Add Methode, um eine Spaltenüberschrift hinzuzufügen, ohne eine Position in der Auflistung anzugeben. Wenn Sie einer Auflistung ein Array von Spaltenüberschriften hinzufügen möchten, verwenden Sie die AddRange Methode.

Gilt für