ListView.ColumnHeaderCollection.Insert 方法

参考

定义

命名空间:: System.Windows.Forms

程序集:: System.Windows.Forms.dll

重要

一些信息与预发行产品相关，相应产品在发行之前可能会进行重大修改。对于此处提供的信息，Microsoft 不作任何明示或暗示的担保。

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

重载

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 该方法。

另请参阅

适用于

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 该方法。

另请参阅

适用于

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 该方法。

适用于

通过

ListView.ColumnHeaderCollection.Insert 方法

定义

重载

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)

参数

例外

注解

适用于