Compartilhar via


ListView.ColumnHeaderCollection.Insert Método

Definição

Insere um cabeçalho de coluna na coleção no índice especificado.

Sobrecargas

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

Cria um novo cabeçalho de coluna com o texto alinhado, a chave, a largura e a chave da imagem especificados e insere o cabeçalho na coleção, no índice especificado.

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

Cria um novo cabeçalho de coluna com o texto alinhado, a chave, a largura e o índice da imagem especificados e insere o cabeçalho na coleção, no índice especificado.

Insert(Int32, String, Int32, HorizontalAlignment)

Cria um novo cabeçalho de coluna e o insere na coleção, no índice especificado.

Insert(Int32, String, String, Int32)

Cria um novo cabeçalho de coluna com o texto, a chave e a largura especificados e insere o cabeçalho na coleção no índice especificado.

Insert(Int32, String, String)

Cria um novo cabeçalho de coluna com o texto e a chave especificados e insere o cabeçalho na coleção no índice especificado.

Insert(Int32, String, Int32)

Cria um novo cabeçalho de coluna com o texto e a largura inicial especificados e insere o cabeçalho na coleção no índice especificado.

Insert(Int32, ColumnHeader)

Insere um cabeçalho de coluna existente na coleção no índice especificado.

Insert(Int32, String)

Cria um novo cabeçalho de coluna com o texto especificado e insere o cabeçalho na coleção no índice especificado.

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

Cria um novo cabeçalho de coluna com o texto alinhado, a chave, a largura e a chave da imagem especificados e insere o cabeçalho na coleção, no índice especificado.

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)

Parâmetros

index
Int32

O local do índice de base zero no qual o cabeçalho de coluna é inserido.

key
String

O nome do cabeçalho da coluna.

text
String

O texto a ser exibido no cabeçalho da coluna.

width
Int32

A largura inicial, em pixels, do cabeçalho da coluna.

textAlign
HorizontalAlignment

Um dos valores de HorizontalAlignment.

imageKey
String

A chave da imagem a ser exibida no cabeçalho da coluna.

Comentários

Para adicionar um cabeçalho de coluna sem especificar uma posição na coleção, use o Add método . Se você quiser adicionar uma matriz de cabeçalhos de coluna à coleção, use o AddRange método .

A Name propriedade corresponde à chave de uma coluna no ListView.ColumnHeaderCollection.

Aplica-se a

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

Cria um novo cabeçalho de coluna com o texto alinhado, a chave, a largura e o índice da imagem especificados e insere o cabeçalho na coleção, no índice especificado.

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)

Parâmetros

index
Int32

O local do índice de base zero no qual o cabeçalho de coluna é inserido.

key
String

O nome do cabeçalho da coluna.

text
String

O texto a ser exibido no cabeçalho da coluna.

width
Int32

A largura inicial, em pixels, do cabeçalho da coluna.

textAlign
HorizontalAlignment

Um dos valores de HorizontalAlignment.

imageIndex
Int32

O índice da imagem a ser exibida no cabeçalho da coluna.

Comentários

Para adicionar um cabeçalho de coluna sem especificar uma posição na coleção, use o Add método . Se você quiser adicionar uma matriz de cabeçalhos de coluna à coleção, use o AddRange método .

A Name propriedade corresponde à chave de uma coluna no ListView.ColumnHeaderCollection.

Aplica-se a

Insert(Int32, String, Int32, HorizontalAlignment)

Cria um novo cabeçalho de coluna e o insere na coleção, no índice especificado.

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)

Parâmetros

index
Int32

O local do índice de base zero no qual o cabeçalho de coluna é inserido.

strtext
String

O texto a ser exibido no cabeçalho da coluna.

width
Int32

A largura inicial do cabeçalho da coluna. Defina como -1 para dimensionar automaticamente o cabeçalho de coluna para o tamanho do texto do maior subitem na coluna ou então como -2 para dimensionar automaticamente o cabeçalho de coluna para o tamanho do texto contido nele.

textAlign
HorizontalAlignment

Um dos valores de HorizontalAlignment.

Exceções

index é menor que 0 ou maior ou igual ao valor da propriedade Count do ListView.ColumnHeaderCollection.

Comentários

Esta versão do Insert método permite que você crie um novo ColumnHeader com uma configuração específica de alinhamento de cabeçalho de coluna, largura e texto e insira-o em uma posição específica no ListView.ColumnHeaderCollection. Você pode usar esse método se quiser inserir um novo cabeçalho de coluna em uma coleção existente de cabeçalhos de coluna. Se você quiser usar um existente ColumnHeader e inseri-lo em uma posição específica na coleção, use a outra versão do Insert método . Para adicionar um cabeçalho de coluna sem especificar uma posição específica na coleção, use o Add método . Se você quiser adicionar uma matriz de cabeçalhos de coluna à coleção, use o AddRange método .

Confira também

Aplica-se a

Insert(Int32, String, String, Int32)

Cria um novo cabeçalho de coluna com o texto, a chave e a largura especificados e insere o cabeçalho na coleção no índice especificado.

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)

Parâmetros

index
Int32

O local do índice de base zero no qual o cabeçalho de coluna é inserido.

key
String

O nome do cabeçalho da coluna.

text
String

O texto a ser exibido no cabeçalho da coluna.

width
Int32

A largura inicial, em pixels, do cabeçalho da coluna.

Comentários

Para adicionar um cabeçalho de coluna sem especificar uma posição na coleção, use o Add método . Se você quiser adicionar uma matriz de cabeçalhos de coluna à coleção, use o AddRange método .

A Name propriedade corresponde à chave de uma coluna no ListView.ColumnHeaderCollection.

Aplica-se a

Insert(Int32, String, String)

Cria um novo cabeçalho de coluna com o texto e a chave especificados e insere o cabeçalho na coleção no índice especificado.

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)

Parâmetros

index
Int32

O local do índice de base zero no qual o cabeçalho de coluna é inserido.

key
String

O nome do cabeçalho da coluna.

text
String

O texto a ser exibido no cabeçalho da coluna.

Comentários

Para adicionar um cabeçalho de coluna sem especificar uma posição na coleção, use o Add método . Se você quiser adicionar uma matriz de cabeçalhos de coluna à coleção, use o AddRange método .

A Name propriedade corresponde à chave de uma coluna no ListView.ColumnHeaderCollection.

Aplica-se a

Insert(Int32, String, Int32)

Cria um novo cabeçalho de coluna com o texto e a largura inicial especificados e insere o cabeçalho na coleção no índice especificado.

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)

Parâmetros

index
Int32

O local do índice de base zero no qual o cabeçalho de coluna é inserido.

text
String

O texto a ser exibido no cabeçalho da coluna.

width
Int32

A largura inicial, em pixels, do cabeçalho da coluna.

Comentários

Para adicionar um cabeçalho de coluna sem especificar uma posição na coleção, use o Add método . Se você quiser adicionar uma matriz de cabeçalhos de coluna à coleção, use o AddRange método .

Aplica-se a

Insert(Int32, ColumnHeader)

Insere um cabeçalho de coluna existente na coleção no índice especificado.

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)

Parâmetros

index
Int32

O local do índice de base zero no qual o cabeçalho de coluna é inserido.

value
ColumnHeader

O ColumnHeader a ser inserido na coleção.

Exceções

index é menor que 0 ou maior ou igual ao valor da propriedade Count do ListView.ColumnHeaderCollection.

Comentários

Essa versão do Insert método permite que você insira um existente ColumnHeader em uma posição específica no ListView.ColumnHeaderCollection.

Se você quiser criar um novo ColumnHeader e inseri-lo em uma posição específica na coleção, use a outra versão do Insert método . Para adicionar um cabeçalho de coluna sem especificar uma posição específica na coleção, use o Add método . Se você quiser adicionar uma matriz de cabeçalhos de coluna à coleção, use o AddRange método .

Confira também

Aplica-se a

Insert(Int32, String)

Cria um novo cabeçalho de coluna com o texto especificado e insere o cabeçalho na coleção no índice especificado.

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)

Parâmetros

index
Int32

O local do índice de base zero no qual o cabeçalho de coluna é inserido.

text
String

O texto a ser exibido no cabeçalho da coluna.

Exceções

index é menor que 0 ou maior ou igual ao valor da propriedade Count do ListView.ColumnHeaderCollection.

Comentários

Para adicionar um cabeçalho de coluna sem especificar uma posição na coleção, use o Add método . Se você quiser adicionar uma matriz de cabeçalhos de coluna à coleção, use o AddRange método .

Aplica-se a