Compartir a través de

ListView.ColumnHeaderCollection.Insert Método

  • Referencia

Definición

Espacio de nombres:
System.Windows.Forms
Ensamblado:
System.Windows.Forms.dll

Inserta un encabezado de columna en la colección, en el índice especificado.

Sobrecargas

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

Crea un nuevo encabezado de columna con el texto alineado, la clave, el ancho y la clave de imagen especificados y lo inserta en la colección, en el índice especificado.
Insert(Int32, String, String, Int32, HorizontalAlignment, Int32)

Crea un nuevo encabezado de columna con el texto alineado, la clave, el ancho y el índice de imagen especificados y lo inserta en la colección, en el índice especificado.
Insert(Int32, String, Int32, HorizontalAlignment)

Crea un nuevo encabezado de columna y lo inserta en la colección, en el índice especificado.
Insert(Int32, String, String, Int32)

Crea un nuevo encabezado de columna con el texto, la clave y el ancho especificados y lo inserta en la colección, en el índice especificado.
Insert(Int32, String, String)

Crea un nuevo encabezado de columna con el texto y la clave especificados y lo inserta en la colección, en el índice especificado.
Insert(Int32, String, Int32)

Crea un nuevo encabezado de columna con el texto y el ancho inicial especificados y lo inserta en la colección, en el índice especificado.
Insert(Int32, ColumnHeader)

Inserta un encabezado de columna existente en la colección, en el índice especificado.
Insert(Int32, String)

Crea un nuevo encabezado de columna con el texto especificado y lo inserta en la colección, en el índice especificado.

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

Crea un nuevo encabezado de columna con el texto alineado, la clave, el ancho y la clave de imagen especificados y lo inserta en la colección, en el í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

Posición de índice de base cero donde se inserta el encabezado de columna.

key
String

El nombre del encabezado de la columna.

text
String

Texto que se va a mostrar en el encabezado de columna.

width
Int32

Ancho inicial, en píxeles, del encabezado de columna.

textAlign
HorizontalAlignment

Uno de los valores de HorizontalAlignment.

imageKey
String

Clave de la imagen que se va a mostrar en el encabezado de columna.

Comentarios

Para agregar un encabezado de columna sin especificar una posición en la colección, use el Add método . Si desea agregar una matriz de encabezados de columna a la colección, use el AddRange método .

La Name propiedad corresponde a la clave de una columna de .ListView.ColumnHeaderCollection

Se aplica a

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

Crea un nuevo encabezado de columna con el texto alineado, la clave, el ancho y el índice de imagen especificados y lo inserta en la colección, en el í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

Posición de índice de base cero donde se inserta el encabezado de columna.

key
String

El nombre del encabezado de la columna.

text
String

Texto que se va a mostrar en el encabezado de columna.

width
Int32

Ancho inicial, en píxeles, del encabezado de columna.

textAlign
HorizontalAlignment

Uno de los valores de HorizontalAlignment.

imageIndex
Int32

Índice de la imagen que se va a mostrar en el encabezado de columna.

Comentarios

Para agregar un encabezado de columna sin especificar una posición en la colección, use el Add método . Si desea agregar una matriz de encabezados de columna a la colección, use el AddRange método .

La Name propiedad corresponde a la clave de una columna de .ListView.ColumnHeaderCollection

Se aplica a

Insert(Int32, String, Int32, HorizontalAlignment)

Crea un nuevo encabezado de columna y lo inserta en la colección, en el í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

Posición de índice de base cero donde se inserta el encabezado de columna.

strtext
String

Texto que se va a mostrar en el encabezado de columna.

width
Int32

Ancho inicial del encabezado de columna. Se establece en -1 para que el encabezado de columna se ajuste automáticamente al tamaño del texto del subelemento más grande de la columna o en -2 para que el encabezado se ajuste automáticamente al tamaño del texto del encabezado de columna.

textAlign
HorizontalAlignment

Uno de los valores de HorizontalAlignment.

Excepciones

ArgumentOutOfRangeException

index es menor que cero o mayor o igual que el valor de la propiedad Count de la colección ListView.ColumnHeaderCollection.

Comentarios

Esta versión del Insert método le permite crear un nuevo con ColumnHeader una configuración específica de alineación de encabezado de columna, ancho y texto e insertarla en una posición específica de ListView.ColumnHeaderCollection. Puede usar este método si desea insertar un nuevo encabezado de columna en una colección existente de encabezados de columna. Si desea usar un existente ColumnHeader e insertarlo en una posición específica de la colección, use la otra versión del Insert método . Para agregar un encabezado de columna sin especificar una posición específica en la colección, use el Add método . Si desea agregar una matriz de encabezados de columna a la colección, use el AddRange método .

Consulte también

Se aplica a

Insert(Int32, String, String, Int32)

Crea un nuevo encabezado de columna con el texto, la clave y el ancho especificados y lo inserta en la colección, en el í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

Posición de índice de base cero donde se inserta el encabezado de columna.

key
String

El nombre del encabezado de la columna.

text
String

Texto que se va a mostrar en el encabezado de columna.

width
Int32

Ancho inicial, en píxeles, del encabezado de columna.

Comentarios

Para agregar un encabezado de columna sin especificar una posición en la colección, use el Add método . Si desea agregar una matriz de encabezados de columna a la colección, use el AddRange método .

La Name propiedad corresponde a la clave de una columna de .ListView.ColumnHeaderCollection

Se aplica a

Insert(Int32, String, String)

Crea un nuevo encabezado de columna con el texto y la clave especificados y lo inserta en la colección, en el í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

Posición de índice de base cero donde se inserta el encabezado de columna.

key
String

El nombre del encabezado de la columna.

text
String

Texto que se va a mostrar en el encabezado de columna.

Comentarios

Para agregar un encabezado de columna sin especificar una posición en la colección, use el Add método . Si desea agregar una matriz de encabezados de columna a la colección, use el AddRange método .

La Name propiedad corresponde a la clave de una columna de .ListView.ColumnHeaderCollection

Se aplica a

Insert(Int32, String, Int32)

Crea un nuevo encabezado de columna con el texto y el ancho inicial especificados y lo inserta en la colección, en el í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

Posición de índice de base cero donde se inserta el encabezado de columna.

text
String

Texto que se va a mostrar en el encabezado de columna.

width
Int32

Ancho inicial, en píxeles, del encabezado de columna.

Comentarios

Para agregar un encabezado de columna sin especificar una posición en la colección, use el Add método . Si desea agregar una matriz de encabezados de columna a la colección, use el AddRange método .

Se aplica a

Insert(Int32, ColumnHeader)

Inserta un encabezado de columna existente en la colección, en el í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

Posición de índice de base cero donde se inserta el encabezado de columna.

value
ColumnHeader

ColumnHeader que se va a insertar en la colección.

Excepciones

ArgumentOutOfRangeException

index es menor que cero o mayor o igual que el valor de la propiedad Count de la colección ListView.ColumnHeaderCollection.

Comentarios

Esta versión del Insert método permite insertar un existente ColumnHeader en una posición específica en .ListView.ColumnHeaderCollection

Si desea crear un nuevo ColumnHeader e insertarlo en una posición específica de la colección, use la otra versión del Insert método . Para agregar un encabezado de columna sin especificar una posición específica en la colección, use el Add método . Si desea agregar una matriz de encabezados de columna a la colección, use el AddRange método .

Consulte también

Se aplica a

Insert(Int32, String)

Crea un nuevo encabezado de columna con el texto especificado y lo inserta en la colección, en el í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

Posición de índice de base cero donde se inserta el encabezado de columna.

text
String

Texto que se va a mostrar en el encabezado de columna.

Excepciones

ArgumentOutOfRangeException

index es menor que cero o mayor o igual que el valor de la propiedad Count de la colección ListView.ColumnHeaderCollection.

Comentarios

Para agregar un encabezado de columna sin especificar una posición en la colección, use el Add método . Si desea agregar una matriz de encabezados de columna a la colección, use el AddRange método .

Se aplica a