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)

Создает новый заголовок столбца с указанным текстом и вставляет заголовок в коллекцию по указанному индексу.

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.

Исключения

Значение параметра 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 для вставки в коллекцию.

Исключения

Значение параметра index меньше 0 либо больше или равно значению свойства Count коллекции ListView.ColumnHeaderCollection.

Комментарии

Эта версия Insert метода позволяет вставить существующий ColumnHeader объект в определенную позицию ListView.ColumnHeaderCollectionв .

Если вы хотите создать новый 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

Текст, отображаемый в заголовке столбца.

Исключения

Значение параметра index меньше 0 либо больше или равно значению свойства Count коллекции ListView.ColumnHeaderCollection.

Комментарии

Чтобы добавить заголовок столбца без указания позиции в коллекции, используйте Add метод . Если вы хотите добавить массив заголовков столбцов в коллекцию, используйте AddRange метод .

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