ListView.ColumnHeaderCollection.Insert 方法

定义

命名空间:

System.Windows.Forms

程序集:

System.Windows.Forms.dll

将列标题插入到集合中的指定索引位置。

重载

Insert(Int32, String, String, Int32, HorizontalAlignment, String)	创建具有指定的对齐文本、键、宽度和图像键的新列标题，并将其插入到集合中指定索引处。
Insert(Int32, String, String, Int32, HorizontalAlignment, Int32)	创建具有指定的对齐文本、键、宽度和图像索引的新列标题，并将其插入到集合中指定索引处。
Insert(Int32, String, Int32, HorizontalAlignment)	新建列标题并将它插入集合中的指定索引位置。
Insert(Int32, String, String, Int32)	创建具有指定的文本、键和宽度的新列标题，并将其插入到集合中指定索引处。
Insert(Int32, String, String)	创建具有指定的文本和键的新列标题，并将其插入到集合中指定索引处。
Insert(Int32, String, Int32)	创建具有指定文本和初始宽度的新列标题，并将其插入到集合中指定索引处。
Insert(Int32, ColumnHeader)	将现有的列标题插入到集合中的指定索引位置。
Insert(Int32, String)	创建具有指定文本的新列标题，并将其插入到集合中指定索引处。

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

创建具有指定的对齐文本、键、宽度和图像键的新列标题，并将其插入到集合中指定索引处。

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)

参数

index

Int32

插入列标题处的从零开始的索引位置。

key

String

列标题的名称。

text

String

要在列标题中显示的文本。

width

Int32

列标题的初始宽度，单位为像素。

textAlign

HorizontalAlignment

HorizontalAlignment 值之一。

imageKey

String

要显示在列标题上的图像的键。

注解

若要在不指定集合中的位置的情况下添加列标题，请使用 Add 该方法。 如果要将列标题数组添加到集合中，请使用 AddRange 该方法。

该 Name 属性对应于列中 ListView.ColumnHeaderCollection的键。

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

创建具有指定的对齐文本、键、宽度和图像索引的新列标题，并将其插入到集合中指定索引处。

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)

参数

index

Int32

插入列标题处的从零开始的索引位置。

key

String

列标题的名称。

text

String

要在列标题中显示的文本。

width

Int32

列标题的初始宽度，单位为像素。

textAlign

HorizontalAlignment

HorizontalAlignment 值之一。

imageIndex

Int32

要显示在列标题上的图像的索引。

注解

若要在不指定集合中的位置的情况下添加列标题，请使用 Add 该方法。 如果要将列标题数组添加到集合中，请使用 AddRange 该方法。

该 Name 属性对应于列中 ListView.ColumnHeaderCollection的键。

Insert(Int32, String, Int32, HorizontalAlignment)

新建列标题并将它插入集合中的指定索引位置。

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)

参数

index

Int32

插入列标题处的从零开始的索引位置。

strtext

String

要在列标题中显示的文本。

width

Int32

列标题的初始宽度。 设置为 -1，则将列标题的大小自动调整为列中最大子项文本的大小，或者设置为 -2，则将列标题的大小自动调整为列标题的文本的大小。

textAlign

HorizontalAlignment

HorizontalAlignment 值之一。

例外

ArgumentOutOfRangeException

index 小于 0，或者大于或等于 Count 的 ListView.ColumnHeaderCollection 属性的值。

注解

使用此方法的 Insert 此版本，可以创建具有特定列标题文本、宽度和文本对齐设置的新 ColumnHeader 内容，并将其插入到 ListView.ColumnHeaderCollection特定位置。 如果要将新列标题插入到列标题的现有集合中，可以使用此方法。 如果要使用现有项 ColumnHeader 并将其插入到集合中的特定位置，请使用该方法的其他版本 Insert 。 若要在不指定集合中的特定位置的情况下添加列标题，请使用 Add 该方法。 如果要将列标题数组添加到集合中，请使用 AddRange 该方法。

另请参阅

• Add(ListViewItem+ListViewSubItem)
• AddRange(ListViewItem+ListViewSubItem[])

Insert(Int32, String, String, Int32)

创建具有指定的文本、键和宽度的新列标题，并将其插入到集合中指定索引处。

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)

参数

index

Int32

插入列标题处的从零开始的索引位置。

key

String

列标题的名称。

text

String

要在列标题中显示的文本。

width

Int32

列标题的初始宽度，单位为像素。

注解

若要在不指定集合中的位置的情况下添加列标题，请使用 Add 该方法。 如果要将列标题数组添加到集合中，请使用 AddRange 该方法。

该 Name 属性对应于列中 ListView.ColumnHeaderCollection的键。

Insert(Int32, String, String)

创建具有指定的文本和键的新列标题，并将其插入到集合中指定索引处。

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)

参数

index

Int32

插入列标题处的从零开始的索引位置。

key

String

列标题的名称。

text

String

要在列标题中显示的文本。

注解

若要在不指定集合中的位置的情况下添加列标题，请使用 Add 该方法。 如果要将列标题数组添加到集合中，请使用 AddRange 该方法。

该 Name 属性对应于列中 ListView.ColumnHeaderCollection的键。

Insert(Int32, String, Int32)

创建具有指定文本和初始宽度的新列标题，并将其插入到集合中指定索引处。

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)

参数

index

Int32

插入列标题处的从零开始的索引位置。

text

String

要在列标题中显示的文本。

width

Int32

列标题的初始宽度，单位为像素。

注解

若要在不指定集合中的位置的情况下添加列标题，请使用 Add 该方法。 如果要将列标题数组添加到集合中，请使用 AddRange 该方法。

Insert(Int32, ColumnHeader)

将现有的列标题插入到集合中的指定索引位置。

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)

参数

index

Int32

插入列标题处的从零开始的索引位置。

value

ColumnHeader

要插入到集合中的 ColumnHeader。

例外

ArgumentOutOfRangeException

index 小于 0，或者大于或等于 Count 的 ListView.ColumnHeaderCollection 属性的值。

注解

使用此方法的Insert此版本，可以在特定位置ListView.ColumnHeaderCollection插入现有ColumnHeader元素。

如果要创建一个新 ColumnHeader 项并将其插入到集合中的特定位置，请使用该方法的其他版本 Insert 。 若要在不指定集合中的特定位置的情况下添加列标题，请使用 Add 该方法。 如果要将列标题数组添加到集合中，请使用 AddRange 该方法。

另请参阅

• Add(ListViewItem+ListViewSubItem)
• AddRange(ListViewItem+ListViewSubItem[])

Insert(Int32, String)

创建具有指定文本的新列标题，并将其插入到集合中指定索引处。

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)

参数

index

Int32

插入列标题处的从零开始的索引位置。

text

String

要在列标题中显示的文本。

例外

ArgumentOutOfRangeException

index 小于 0，或者大于或等于 Count 的 ListView.ColumnHeaderCollection 属性的值。

注解

若要在不指定集合中的位置的情况下添加列标题，请使用 Add 该方法。 如果要将列标题数组添加到集合中，请使用 AddRange 该方法。