Partager via

ListView.ColumnHeaderCollection.Insert Méthode

  • Référence

Définition

Espace de noms:
System.Windows.Forms
Assembly:
System.Windows.Forms.dll

Insère un en-tête de colonne dans la collection à la position d'index spécifiée.

Surcharges

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

Crée un en-tête de colonne avec le texte aligné, la clé, la largeur et la clé d'image spécifiés et l'insère dans la collection à l'index spécifié.
Insert(Int32, String, String, Int32, HorizontalAlignment, Int32)

Crée un en-tête de colonne avec le texte aligné, la clé, la largeur et l'index d'image spécifiés et l'insère dans la collection à l'index spécifié.
Insert(Int32, String, Int32, HorizontalAlignment)

Crée un nouvel en-tête de colonne et l'insère dans la collection à la position d'index spécifiée.
Insert(Int32, String, String, Int32)

Crée un en-tête de colonne avec le texte, la clé et la largeur initiale spécifiés et l'insère dans la collection à l'index spécifié.
Insert(Int32, String, String)

Crée un en-tête de colonne avec le texte et la clé spécifiés et l'insère dans la collection à l'index spécifié.
Insert(Int32, String, Int32)

Crée un en-tête de colonne avec le texte et la largeur initiale spécifiés et l'insère dans la collection à l'index spécifié.
Insert(Int32, ColumnHeader)

Insère un en-tête de colonne existant dans la collection à l'index spécifié.
Insert(Int32, String)

Crée un en-tête de colonne avec le texte spécifié et l'insère dans la collection à l'index spécifié.

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

Crée un en-tête de colonne avec le texte aligné, la clé, la largeur et la clé d'image spécifiés et l'insère dans la collection à l'index spécifié.

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)

Paramètres

index
Int32

Position d'index de base zéro où l'en-tête de colonne est inséré.

key
String

Le nom de l'en-tête de colonne.

text
String

Texte à afficher dans l'en-tête de colonne.

width
Int32

Largeur initiale, en pixels, de l'en-tête de colonne.

textAlign
HorizontalAlignment

Une des valeurs de l'objet HorizontalAlignment.

imageKey
String

Clé de l'image à afficher dans l'en-tête de colonne

Remarques

Pour ajouter un en-tête de colonne sans spécifier de position dans la collection, utilisez la Add méthode . Si vous souhaitez ajouter un tableau d’en-têtes de colonne à la collection, utilisez la AddRange méthode .

La Name propriété correspond à la clé d’une colonne dans .ListView.ColumnHeaderCollection

S’applique à

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

Crée un en-tête de colonne avec le texte aligné, la clé, la largeur et l'index d'image spécifiés et l'insère dans la collection à l'index spécifié.

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)

Paramètres

index
Int32

Position d'index de base zéro où l'en-tête de colonne est inséré.

key
String

Le nom de l'en-tête de colonne.

text
String

Texte à afficher dans l'en-tête de colonne.

width
Int32

Largeur initiale, en pixels, de l'en-tête de colonne.

textAlign
HorizontalAlignment

Une des valeurs de l'objet HorizontalAlignment.

imageIndex
Int32

Index de l'image à afficher dans l'en-tête de colonne

Remarques

Pour ajouter un en-tête de colonne sans spécifier de position dans la collection, utilisez la Add méthode . Si vous souhaitez ajouter un tableau d’en-têtes de colonne à la collection, utilisez la AddRange méthode .

La Name propriété correspond à la clé d’une colonne dans .ListView.ColumnHeaderCollection

S’applique à

Insert(Int32, String, Int32, HorizontalAlignment)

Crée un nouvel en-tête de colonne et l'insère dans la collection à la position d'index spécifiée.

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)

Paramètres

index
Int32

Position d'index de base zéro où l'en-tête de colonne est inséré.

strtext
String

Texte à afficher dans l'en-tête de colonne.

width
Int32

Largeur initiale de l'en-tête de colonne. Affectez la valeur -1 pour dimensionner automatiquement l'en-tête de colonne en fonction du texte de sous-élément le plus large de la colonne ; affectez la valeur -2 pour dimensionner automatiquement l'en-tête de colonne en fonction de la taille du texte qu'il contient.

textAlign
HorizontalAlignment

Une des valeurs de l'objet HorizontalAlignment.

Exceptions

ArgumentOutOfRangeException

index est inférieur à zéro, ou supérieur ou égal à la valeur de la propriété Count de ListView.ColumnHeaderCollection.

Remarques

Cette version de la Insert méthode vous permet de créer un nouveau ColumnHeader avec le texte d’en-tête de colonne, la largeur et le paramètre d’alignement du texte, et de l’insérer à une position spécifique dans le ListView.ColumnHeaderCollection. Vous pouvez utiliser cette méthode si vous souhaitez insérer un nouvel en-tête de colonne dans une collection existante d’en-têtes de colonne. Si vous souhaitez utiliser un existant ColumnHeader et l’insérer à une position spécifique dans la collection, utilisez l’autre version de la Insert méthode . Pour ajouter un en-tête de colonne sans spécifier de position spécifique dans la collection, utilisez la Add méthode . Si vous souhaitez ajouter un tableau d’en-têtes de colonne à la collection, utilisez la AddRange méthode .

Voir aussi

S’applique à

Insert(Int32, String, String, Int32)

Crée un en-tête de colonne avec le texte, la clé et la largeur initiale spécifiés et l'insère dans la collection à l'index spécifié.

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)

Paramètres

index
Int32

Position d'index de base zéro où l'en-tête de colonne est inséré.

key
String

Le nom de l'en-tête de colonne.

text
String

Texte à afficher dans l'en-tête de colonne.

width
Int32

Largeur initiale, en pixels, de l'en-tête de colonne.

Remarques

Pour ajouter un en-tête de colonne sans spécifier de position dans la collection, utilisez la Add méthode . Si vous souhaitez ajouter un tableau d’en-têtes de colonne à la collection, utilisez la AddRange méthode .

La Name propriété correspond à la clé d’une colonne dans .ListView.ColumnHeaderCollection

S’applique à

Insert(Int32, String, String)

Crée un en-tête de colonne avec le texte et la clé spécifiés et l'insère dans la collection à l'index spécifié.

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)

Paramètres

index
Int32

Position d'index de base zéro où l'en-tête de colonne est inséré.

key
String

Le nom de l'en-tête de colonne.

text
String

Texte à afficher dans l'en-tête de colonne.

Remarques

Pour ajouter un en-tête de colonne sans spécifier de position dans la collection, utilisez la Add méthode . Si vous souhaitez ajouter un tableau d’en-têtes de colonne à la collection, utilisez la AddRange méthode .

La Name propriété correspond à la clé d’une colonne dans .ListView.ColumnHeaderCollection

S’applique à

Insert(Int32, String, Int32)

Crée un en-tête de colonne avec le texte et la largeur initiale spécifiés et l'insère dans la collection à l'index spécifié.

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)

Paramètres

index
Int32

Position d'index de base zéro où l'en-tête de colonne est inséré.

text
String

Texte à afficher dans l'en-tête de colonne.

width
Int32

Largeur initiale, en pixels, de l'en-tête de colonne.

Remarques

Pour ajouter un en-tête de colonne sans spécifier de position dans la collection, utilisez la Add méthode . Si vous souhaitez ajouter un tableau d’en-têtes de colonne à la collection, utilisez la AddRange méthode .

S’applique à

Insert(Int32, ColumnHeader)

Insère un en-tête de colonne existant dans la collection à l'index spécifié.

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)

Paramètres

index
Int32

Position d'index de base zéro où l'en-tête de colonne est inséré.

value
ColumnHeader

ColumnHeader à insérer dans la collection.

Exceptions

ArgumentOutOfRangeException

index est inférieur à zéro, ou supérieur ou égal à la valeur de la propriété Count de ListView.ColumnHeaderCollection.

Remarques

Cette version de la Insert méthode vous permet d’insérer un existant ColumnHeader à une position spécifique dans le ListView.ColumnHeaderCollection.

Si vous souhaitez créer un nouveau ColumnHeader et l’insérer à un emplacement spécifique dans la collection, utilisez l’autre version de la Insert méthode . Pour ajouter un en-tête de colonne sans spécifier de position spécifique dans la collection, utilisez la Add méthode . Si vous souhaitez ajouter un tableau d’en-têtes de colonne à la collection, utilisez la AddRange méthode .

Voir aussi

S’applique à

Insert(Int32, String)

Crée un en-tête de colonne avec le texte spécifié et l'insère dans la collection à l'index spécifié.

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)

Paramètres

index
Int32

Position d'index de base zéro où l'en-tête de colonne est inséré.

text
String

Texte à afficher dans l'en-tête de colonne.

Exceptions

ArgumentOutOfRangeException

index est inférieur à zéro, ou supérieur ou égal à la valeur de la propriété Count de ListView.ColumnHeaderCollection.

Remarques

Pour ajouter un en-tête de colonne sans spécifier de position dans la collection, utilisez la Add méthode . Si vous souhaitez ajouter un tableau d’en-têtes de colonne à la collection, utilisez la AddRange méthode .

S’applique à