ListView.ColumnHeaderCollection.Insert Метод

Определение

Вставляет заголовок столбца в коллекцию по указанному индексу.Inserts a column 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.

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)

Параметры

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

Одно из значений перечисления HorizontalAlignment.One of the HorizontalAlignment values.

imageKey
String

Ключ изображения для отображения в заголовке столбца.The key of the image to display in the column header.

Комментарии

Чтобы добавить заголовок столбца без указания его расположения в коллекции, используйте Add метод.To add a column header without specifying a position in the collection, use the Add method. Если необходимо добавить в коллекцию массив заголовков столбцов, используйте AddRange метод.If you want to add an array of column headers to the collection, use the AddRange method.

Свойство соответствует ключу для столбца ListView.ColumnHeaderCollectionв. NameThe Name property corresponds to the key for a column in the ListView.ColumnHeaderCollection.

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)

Параметры

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

Одно из значений HorizontalAlignment.One of the HorizontalAlignment values.

imageIndex
Int32

Значение изображения для отображения в заголовке столбца.The index of the image to display in the column header.

Комментарии

Чтобы добавить заголовок столбца без указания его расположения в коллекции, используйте Add метод.To add a column header without specifying a position in the collection, use the Add method. Если необходимо добавить в коллекцию массив заголовков столбцов, используйте AddRange метод.If you want to add an array of column headers to the collection, use the AddRange method.

Свойство соответствует ключу для столбца ListView.ColumnHeaderCollectionв. NameThe Name property corresponds to the key for a column in the ListView.ColumnHeaderCollection.

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, string str, int width, System.Windows.Forms.HorizontalAlignment textAlign);
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)

Параметры

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 of the column header. Устанавливается равным -1 для автоматической подгонки размера заголовка столбца к размеру самого длинного текста подэлемента в столбце, или же равным -2 для автоматической подгонки размера заголовка столбца к размеру текста в этом заголовке.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

Одно из значений HorizontalAlignment.One of the HorizontalAlignment values.

Исключения

Значение параметра index меньше 0 либо больше или равно значению свойства Count коллекции ListView.ColumnHeaderCollection.index is less than 0 or greater than or equal to the value of the Count property of the ListView.ColumnHeaderCollection.

Комментарии

Эта версия Insert метода позволяет создать новый ColumnHeader параметр с заданным текстом, шириной и выравниванием текста, а затем вставить его в определенное положение в ListView.ColumnHeaderCollection.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. Если вы хотите использовать существующий ColumnHeader объект и вставить его в определенной позиции в коллекции, используйте другую версию Insert метода.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. Чтобы добавить заголовок столбца без указания определенного места в коллекции, используйте Add метод.To add a column header without specifying a specific position in the collection, use the Add method. Если необходимо добавить в коллекцию массив заголовков столбцов, используйте AddRange метод.If you want to add an array of column headers to the collection, use the AddRange method.

Дополнительно

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)

Параметры

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.

Комментарии

Чтобы добавить заголовок столбца без указания его расположения в коллекции, используйте Add метод.To add a column header without specifying a position in the collection, use the Add method. Если необходимо добавить в коллекцию массив заголовков столбцов, используйте AddRange метод.If you want to add an array of column headers to the collection, use the AddRange method.

Свойство соответствует ключу для столбца ListView.ColumnHeaderCollectionв. NameThe Name property corresponds to the key for a column in the ListView.ColumnHeaderCollection.

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)

Параметры

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.

Комментарии

Чтобы добавить заголовок столбца без указания его расположения в коллекции, используйте Add метод.To add a column header without specifying a position in the collection, use the Add method. Если необходимо добавить в коллекцию массив заголовков столбцов, используйте AddRange метод.If you want to add an array of column headers to the collection, use the AddRange method.

Свойство соответствует ключу для столбца ListView.ColumnHeaderCollectionв. NameThe Name property corresponds to the key for a column in the ListView.ColumnHeaderCollection.

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)

Параметры

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.

Комментарии

Чтобы добавить заголовок столбца без указания его расположения в коллекции, используйте Add метод.To add a column header without specifying a position in the collection, use the Add method. Если необходимо добавить в коллекцию массив заголовков столбцов, используйте AddRange метод.If you want to add an array of column headers to the collection, use the AddRange method.

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)

Параметры

index
Int32

Индекс положения, в которое вставлен данный заголовок столбца (индексация ведется от нуля).The zero-based index location where the column header is inserted.

value
ColumnHeader

Объект ColumnHeader для вставки в коллекцию.The ColumnHeader to insert into the collection.

Исключения

Значение параметра index меньше 0 либо больше или равно значению свойства Count коллекции ListView.ColumnHeaderCollection.index is less than 0 or greater than or equal to the value of the Count property of the ListView.ColumnHeaderCollection.

Комментарии

Эта версия Insert метода позволяет вставить существующий ColumnHeader объект в определенное расположение в ListView.ColumnHeaderCollection.This version of the Insert method enables you to insert an existing ColumnHeader at a specific position in the ListView.ColumnHeaderCollection.

Если вы хотите создать новый ColumnHeader объект и вставить его в определенной позиции в коллекции, используйте другую версию Insert метода.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. Чтобы добавить заголовок столбца без указания определенного места в коллекции, используйте Add метод.To add a column header without specifying a specific position in the collection, use the Add method. Если необходимо добавить в коллекцию массив заголовков столбцов, используйте AddRange метод.If you want to add an array of column headers to the collection, use the AddRange method.

Дополнительно

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)

Параметры

index
Int32

Индекс положения, в которое вставлен данный заголовок столбца (индексация ведется от нуля).The zero-based index location where the column header is inserted.

text
String

Текст, отображаемый в заголовке столбца.The text to display in the column header.

Исключения

Значение параметра index меньше 0 либо больше или равно значению свойства Count коллекции ListView.ColumnHeaderCollection.index is less than 0 or greater than or equal to the value of the Count property of the ListView.ColumnHeaderCollection.

Комментарии

Чтобы добавить заголовок столбца без указания его расположения в коллекции, используйте Add метод.To add a column header without specifying a position in the collection, use the Add method. Если необходимо добавить в коллекцию массив заголовков столбцов, используйте AddRange метод.If you want to add an array of column headers to the collection, use the AddRange method.

Применяется к