ListView.ColumnHeaderCollection.Insert Method

Reference

Definition

Namespace:: System.Windows.Forms

Assembly:: System.Windows.Forms.dll

Important

Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.

Inserts a column header into the collection at the specified index.

Overloads

Insert(Int32, String, String, Int32, HorizontalAlignment, String)	Creates a new column header with the specified aligned text, key, width, and image key, and inserts the header into the collection at the specified index.
Insert(Int32, String, String, Int32, HorizontalAlignment, Int32)	Creates a new column header with the specified aligned text, key, width, and image index, and inserts the header into the collection at the specified index.
Insert(Int32, String, Int32, HorizontalAlignment)	Creates a new column header and inserts it into the collection at the specified index.
Insert(Int32, String, String, Int32)	Creates a new column header with the specified text, key, and width, and inserts the header into the collection at the specified index.
Insert(Int32, String, String)	Creates a new column header with the specified text and key, and inserts the header into the collection at the specified index.
Insert(Int32, String, Int32)	Creates a new column header with the specified text and initial width, and inserts the header into the collection at the specified index.
Insert(Int32, ColumnHeader)	Inserts an existing column header into the collection at the specified index.
Insert(Int32, String)	Creates a new column header with the specified text, and inserts the header into the collection at the specified index.

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

Creates a new column header with the specified aligned text, key, width, and image key, and inserts the header into the collection at the specified index.

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)

Parameters

index: Int32

The zero-based index location where the column header is inserted.

key: String

The name of the column header.

text: String

The text to display in the column header.

width: Int32

The initial width, in pixels, of the column header.

textAlign: HorizontalAlignment

One of the HorizontalAlignment values.

imageKey: String

The key of the image to display in the column header.

Remarks

To add a column header without specifying a position in the collection, use the Add method. If you want to add an array of column headers to the collection, use the AddRange method.

The Name property corresponds to the key for a column in the ListView.ColumnHeaderCollection.

Applies to

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

Creates a new column header with the specified aligned text, key, width, and image index, and inserts the header into the collection at the specified index.

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)

Parameters

index: Int32

The zero-based index location where the column header is inserted.

key: String

The name of the column header.

text: String

The text to display in the column header.

width: Int32

The initial width, in pixels, of the column header.

textAlign: HorizontalAlignment

One of the HorizontalAlignment values.

imageIndex: Int32

The index of the image to display in the column header.

Remarks

To add a column header without specifying a position in the collection, use the Add method. If you want to add an array of column headers to the collection, use the AddRange method.

The Name property corresponds to the key for a column in the ListView.ColumnHeaderCollection.

Applies to

Insert(Int32, String, Int32, HorizontalAlignment)

Creates a new column header and inserts it into the collection at the specified index.

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)

Parameters

index: Int32

The zero-based index location where the column header is inserted.

strtext: String

The text to display in the column header.

width: Int32

The initial width of the column header. Set to -1 to autosize the column header to the size of the largest subitem text in the column or -2 to autosize the column header to the size of the text of the column header.

textAlign: HorizontalAlignment

One of the HorizontalAlignment values.

Exceptions

ArgumentOutOfRangeException

index is less than 0 or greater than or equal to the value of the Count property of the ListView.ColumnHeaderCollection.

Remarks

This version of the Insert method enables you to create a new ColumnHeader with specific column header text, width, and text alignment setting and insert it at a specific position in the ListView.ColumnHeaderCollection. You can use this method if you want to insert a new column header into an existing collection of column headers. If you want to use an existing ColumnHeader and insert it at a specific position in the collection, use the other version of the Insert method. To add a column header without specifying a specific position in the collection, use the Add method. If you want to add an array of column headers to the collection, use the AddRange method.

Applies to

Insert(Int32, String, String, Int32)

Creates a new column header with the specified text, key, and width, and inserts the header into the collection at the specified index.

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)

Parameters

index: Int32

The zero-based index location where the column header is inserted.

key: String

The name of the column header.

text: String

The text to display in the column header.

width: Int32

The initial width, in pixels, of the column header.

Remarks

To add a column header without specifying a position in the collection, use the Add method. If you want to add an array of column headers to the collection, use the AddRange method.

The Name property corresponds to the key for a column in the ListView.ColumnHeaderCollection.

Applies to

Insert(Int32, String, String)

Creates a new column header with the specified text and key, and inserts the header into the collection at the specified index.

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)

Parameters

index: Int32

The zero-based index location where the column header is inserted.

key: String

The name of the column header.

text: String

The text to display in the column header.

Remarks

To add a column header without specifying a position in the collection, use the Add method. If you want to add an array of column headers to the collection, use the AddRange method.

The Name property corresponds to the key for a column in the ListView.ColumnHeaderCollection.

Applies to

Insert(Int32, String, Int32)

Creates a new column header with the specified text and initial width, and inserts the header into the collection at the specified index.

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)

Parameters

index: Int32

The zero-based index location where the column header is inserted.

text: String

The text to display in the column header.

width: Int32

The initial width, in pixels, of the column header.

Remarks

To add a column header without specifying a position in the collection, use the Add method. If you want to add an array of column headers to the collection, use the AddRange method.

Applies to

Insert(Int32, ColumnHeader)

Inserts an existing column header into the collection at the specified index.

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)

Parameters

index: Int32

The zero-based index location where the column header is inserted.

value: ColumnHeader

The ColumnHeader to insert into the collection.

Exceptions

ArgumentOutOfRangeException

index is less than 0 or greater than or equal to the value of the Count property of the ListView.ColumnHeaderCollection.

Remarks

This version of the Insert method enables you to insert an existing ColumnHeader at a specific position in the ListView.ColumnHeaderCollection.

If you want to create a new ColumnHeader and insert it at a specific position in the collection, use the other version of the Insert method. To add a column header without specifying a specific position in the collection, use the Add method. If you want to add an array of column headers to the collection, use the AddRange method.

Applies to

Insert(Int32, String)

Creates a new column header with the specified text, and inserts the header into the collection at the specified index.

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)

Parameters

index: Int32

The zero-based index location where the column header is inserted.

text: String

The text to display in the column header.

Exceptions

ArgumentOutOfRangeException

index is less than 0 or greater than or equal to the value of the Count property of the ListView.ColumnHeaderCollection.

Remarks

To add a column header without specifying a position in the collection, use the Add method. If you want to add an array of column headers to the collection, use the AddRange method.

Applies to

Megosztás a következőn keresztül:

ListView.ColumnHeaderCollection.Insert Method

Definition

Overloads

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

Parameters

Remarks

Applies to

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

Parameters

Remarks

Applies to

Insert(Int32, String, Int32, HorizontalAlignment)

Parameters

Exceptions

Remarks

See also

Applies to

Insert(Int32, String, String, Int32)

Parameters

Remarks

Applies to

Insert(Int32, String, String)

Parameters

Remarks

Applies to

Insert(Int32, String, Int32)

Parameters

Remarks

Applies to

Insert(Int32, ColumnHeader)

Parameters

Exceptions

Remarks

See also

Applies to

Insert(Int32, String)

Parameters

Exceptions

Remarks

Applies to

További források