ColumnHeader Classe

Définition

Affiche un en-tête de colonne unique dans un contrôle ListView.Displays a single column header in a ListView control.

public ref class ColumnHeader : System::ComponentModel::Component, ICloneable
[System.ComponentModel.TypeConverter(typeof(System.Windows.Forms.ColumnHeaderConverter))]
public class ColumnHeader : System.ComponentModel.Component, ICloneable
type ColumnHeader = class
    inherit Component
    interface ICloneable
Public Class ColumnHeader
Inherits Component
Implements ICloneable
Héritage
Attributs
Implémente

Exemples

L’exemple de code suivant illustre l’initialisation d’un contrôle ListView.The following code example demonstrates initializing a ListView control. L’exemple crée ColumnHeader objets et définit les propriétés de Text, TextAlign et Width de l’en-tête de colonne.The example creates ColumnHeader objects and sets the column header's Text, TextAlign and Width properties. L’exemple ajoute également des éléments et des sous-éléments au ListView.The example also adds items and subitems to the ListView. Pour exécuter cet exemple, collez le code suivant dans un formulaire et appelez la méthode PopulateListView à partir du constructeur du formulaire ou du gestionnaire d’événements Load.To run this example paste the following code in a form and call the PopulateListView method from the form's constructor or Load event handler.

private:
   void PopulateListView()
   {
      ListView1->Width = 270;
      ListView1->Location = System::Drawing::Point( 10, 10 );
      
      // Declare and construct the ColumnHeader objects.
      ColumnHeader^ header1;
      ColumnHeader^ header2;
      header1 = gcnew ColumnHeader;
      header2 = gcnew ColumnHeader;
      
      // Set the text, alignment and width for each column header.
      header1->Text = "File name";
      header1->TextAlign = HorizontalAlignment::Left;
      header1->Width = 70;
      header2->TextAlign = HorizontalAlignment::Left;
      header2->Text = "Location";
      header2->Width = 200;
      
      // Add the headers to the ListView control.
      ListView1->Columns->Add( header1 );
      ListView1->Columns->Add( header2 );
            
      // Specify that each item appears on a separate line.
      ListView1->View = View::Details;

      // Populate the ListView.Items property.
      // Set the directory to the sample picture directory.
      System::IO::DirectoryInfo^ dirInfo = gcnew System::IO::DirectoryInfo( "C:\\Documents and Settings\\All Users"
      "\\Documents\\My Pictures\\Sample Pictures" );
      
      // Get the .jpg files from the directory
      array<System::IO::FileInfo^>^files = dirInfo->GetFiles( "*.jpg" );
      
      // Add each file name and full name including path
      // to the ListView.
      if ( files != nullptr )
      {
         System::Collections::IEnumerator^ myEnum = files->GetEnumerator();
         while ( myEnum->MoveNext() )
         {
            System::IO::FileInfo^ file = safe_cast<System::IO::FileInfo^>(myEnum->Current);
            ListViewItem^ item = gcnew ListViewItem( file->Name );
            item->SubItems->Add( file->FullName );
            ListView1->Items->Add( item );
         }
      }
   }
private void PopulateListView()
{
    ListView1.Width = 270;
    ListView1.Location = new System.Drawing.Point(10, 10);

    // Declare and construct the ColumnHeader objects.
    ColumnHeader header1, header2;
    header1 = new ColumnHeader();
    header2 = new ColumnHeader();

    // Set the text, alignment and width for each column header.
    header1.Text = "File name";
    header1.TextAlign = HorizontalAlignment.Left;
    header1.Width = 70;

    header2.TextAlign = HorizontalAlignment.Left;
    header2.Text = "Location";
    header2.Width = 200;

    // Add the headers to the ListView control.
    ListView1.Columns.Add(header1);
    ListView1.Columns.Add(header2);

    // Specify that each item appears on a separate line.
    ListView1.View = View.Details;
    
    // Populate the ListView.Items property.
    // Set the directory to the sample picture directory.
    System.IO.DirectoryInfo dirInfo = 
        new System.IO.DirectoryInfo(
        "C:\\Documents and Settings\\All Users" +
        "\\Documents\\My Pictures\\Sample Pictures");

    // Get the .jpg files from the directory
    System.IO.FileInfo[] files = dirInfo.GetFiles("*.jpg");

    // Add each file name and full name including path
    // to the ListView.
    if (files != null)
    {
        foreach ( System.IO.FileInfo file in files )
        {
            ListViewItem item = new ListViewItem(file.Name);
            item.SubItems.Add(file.FullName);
            ListView1.Items.Add(item);
        }
    }
}
Private Sub PopulateListView()
    ListView1.Width = 270
    ListView1.Location = New System.Drawing.Point(10, 10)

    ' Declare and construct the ColumnHeader objects.
    Dim header1, header2 As ColumnHeader
    header1 = New ColumnHeader
    header2 = New ColumnHeader

    ' Set the text, alignment and width for each column header.
    header1.Text = "File name"
    header1.TextAlign = HorizontalAlignment.Left
    header1.Width = 70

    header2.TextAlign = HorizontalAlignment.Left
    header2.Text = "Location"
    header2.Width = 200

    ' Add the headers to the ListView control.
    ListView1.Columns.Add(header1)
    ListView1.Columns.Add(header2)

    ' Specify that each item appears on a separate line.
    ListView1.View = View.Details

    ' Populate the ListView.Items property.
    ' Set the directory to the sample picture directory.
    Dim dirInfo As New System.IO.DirectoryInfo _
        ("C:\Documents and Settings\All Users" _
        & "\Documents\My Pictures\Sample Pictures")
    Dim file As System.IO.FileInfo

    ' Get the .jpg files from the directory
    Dim files() As System.io.FileInfo = dirInfo.GetFiles("*.jpg")

    ' Add each file name and full name including path
    ' to the ListView.
    If (files IsNot Nothing) Then
        For Each file In files
            Dim item As New ListViewItem(file.Name)
            item.SubItems.Add(file.FullName)
            ListView1.Items.Add(item)
        Next
    End If
End Sub

Remarques

Un en-tête de colonne est un élément dans un contrôle de ListView qui contient le texte de titre.A column header is an item in a ListView control that contains heading text. les objets ColumnHeader peuvent être ajoutés à une ListView à l’aide de la méthode Add de la classe ListView.ColumnHeaderCollection.ColumnHeader objects can be added to a ListView using the Add method of the ListView.ColumnHeaderCollection class. Pour ajouter un groupe de colonnes à une ListView, vous pouvez utiliser la méthode AddRange de la classe ListView.ColumnHeaderCollection.To add a group of columns to a ListView, you can use the AddRange method of the ListView.ColumnHeaderCollection class. Vous pouvez utiliser la propriété Index de la classe ColumnHeader pour déterminer où se trouve le ColumnHeader dans le ListView.ColumnHeaderCollection.You can use the Index property of the ColumnHeader class to determine where the ColumnHeader is located in the ListView.ColumnHeaderCollection.

ColumnHeader fournit les propriétés Text et TextAlign pour définir le texte affiché dans le contrôle et l’alignement du texte dans l’en-tête de colonne.ColumnHeader provides the Text and TextAlign properties to set the text displayed in the control and the alignment of the text in the column header. Pour déterminer si un ColumnHeader est associé à un contrôle ListView, vous pouvez référencer la propriété ListView.To determine whether a ColumnHeader is associated with a ListView control, you can reference the ListView property. Si vous souhaitez copier un ColumnHeader pour l’utiliser dans un autre contrôle ListView, vous pouvez utiliser la méthode Clone.If you want to copy a ColumnHeader for use in another ListView control, you can use the Clone method.

Constructeurs

ColumnHeader()

Initialise une nouvelle instance de la classe ColumnHeader.Initializes a new instance of the ColumnHeader class.

ColumnHeader(Int32)

Initialise une nouvelle instance de la classe ColumnHeader avec l'image spécifiée.Initializes a new instance of the ColumnHeader class with the image specified.

ColumnHeader(String)

Initialise une nouvelle instance de la classe ColumnHeader avec l'image spécifiée.Initializes a new instance of the ColumnHeader class with the image specified.

Propriétés

CanRaiseEvents

Obtient une valeur qui indique si le composant peut déclencher un événement.Gets a value indicating whether the component can raise an event.

(Hérité de Component)
Container

Obtient le IContainer qui contient Component.Gets the IContainer that contains the Component.

(Hérité de Component)
DesignMode

Obtient une valeur qui indique si Component est actuellement en mode design.Gets a value that indicates whether the Component is currently in design mode.

(Hérité de Component)
DisplayIndex

Obtient ou définit l'ordre d'affichage de la colonne par rapport aux colonnes actuellement affichées.Gets or sets the display order of the column relative to the currently displayed columns.

Events

Obtient la liste des gestionnaires d'événements attachés à ce Component.Gets the list of event handlers that are attached to this Component.

(Hérité de Component)
ImageIndex

Obtient ou définit l'index de l'image affichée dans ColumnHeader.Gets or sets the index of the image displayed in the ColumnHeader.

ImageKey

Obtient ou définit la clé de l'image affichée dans la colonneGets or sets the key of the image displayed in the column.

ImageList

Obtient la liste d'images associée au ColumnHeader.Gets the image list associated with the ColumnHeader.

Index

Obtient l'emplacement avec le ListView du contrôle ListView.ColumnHeaderCollection de cette colonne.Gets the location with the ListView control's ListView.ColumnHeaderCollection of this column.

ListView

Obtient le contrôle ListView contenant ColumnHeader.Gets the ListView control the ColumnHeader is located in.

Name

Obtient ou définit le nom de l'objet ColumnHeader.Gets or sets the name of the ColumnHeader.

Site

Obtient ou définit le ISite de Component.Gets or sets the ISite of the Component.

(Hérité de Component)
Tag

Obtient ou définit un objet qui contient les données à associer au ColumnHeader.Gets or sets an object that contains data to associate with the ColumnHeader.

Text

Obtient ou définit le texte affiché dans l'en-tête de colonne.Gets or sets the text displayed in the column header.

TextAlign

Obtient ou définit l'alignement horizontal du texte affiché dans ColumnHeader.Gets or sets the horizontal alignment of the text displayed in the ColumnHeader.

Width

Obtient ou définit la largeur de la colonne.Gets or sets the width of the column.

Méthodes

AutoResize(ColumnHeaderAutoResizeStyle)

Redimensionne la largeur de la colonne comme indiqué par le style de redimensionnement.Resizes the width of the column as indicated by the resize style.

Clone()

Crée une copie de ColumnHeader en cours qui n'est attaché à aucun contrôle list view.Creates an identical copy of the current ColumnHeader that is not attached to any list view control.

CreateObjRef(Type)

Crée un objet contenant toutes les informations appropriées requises pour générer un proxy permettant de communiquer avec un objet distant.Creates an object that contains all the relevant information required to generate a proxy used to communicate with a remote object.

(Hérité de MarshalByRefObject)
Dispose()

Libère toutes les ressources utilisées par Component.Releases all resources used by the Component.

(Hérité de Component)
Dispose(Boolean)

Libère les ressources (autres que la mémoire) utilisées par ColumnHeader.Disposes of the resources (other than memory) used by the ColumnHeader.

Equals(Object)

Détermine si l'objet spécifié est égal à l'objet actuel.Determines whether the specified object is equal to the current object.

(Hérité de Object)
GetHashCode()

Sert de fonction de hachage par défaut.Serves as the default hash function.

(Hérité de Object)
GetLifetimeService()

Récupère l'objet de service de durée de vie en cours qui contrôle la stratégie de durée de vie de cette instance.Retrieves the current lifetime service object that controls the lifetime policy for this instance.

(Hérité de MarshalByRefObject)
GetService(Type)

Retourne un objet qui représente un service fourni par Component ou par son Container.Returns an object that represents a service provided by the Component or by its Container.

(Hérité de Component)
GetType()

Obtient le Type de l'instance actuelle.Gets the Type of the current instance.

(Hérité de Object)
InitializeLifetimeService()

Obtient un objet de service de durée de vie pour contrôler la stratégie de durée de vie de cette instance.Obtains a lifetime service object to control the lifetime policy for this instance.

(Hérité de MarshalByRefObject)
MemberwiseClone()

Crée une copie superficielle du Object actuel.Creates a shallow copy of the current Object.

(Hérité de Object)
MemberwiseClone(Boolean)

Crée une copie superficielle de l'objet MarshalByRefObject actuel.Creates a shallow copy of the current MarshalByRefObject object.

(Hérité de MarshalByRefObject)
ToString()

Retourne un String contenant le nom du Component, s’il en existe un.Returns a String containing the name of the Component, if any. Cette méthode ne doit pas être remplacée.This method should not be overridden.

Événements

Disposed

Se produit lorsque le composant est supprimé par un appel à la méthode Dispose().Occurs when the component is disposed by a call to the Dispose() method.

(Hérité de Component)

S’applique à

Voir aussi