ColumnHeader ColumnHeader ColumnHeader ColumnHeader Class

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 ListView d’un contrôle.The following code example demonstrates initializing a ListView control. L’exemple crée ColumnHeader des objets et définit les propriétés TextAlign et Text 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- ListViewéléments à l'.The example also adds items and subitems to the ListView. Pour exécuter cet exemple, collez le code suivant dans un formulaire et PopulateListView appelez la méthode à partir du constructeur Load ou du gestionnaire d’événements du formulaire.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 ListView élément dans un contrôle qui contient le texte de titre.A column header is an item in a ListView control that contains heading text. ColumnHeaderles objets peuvent être ajoutés à ListView un à Add l’aide de ListView.ColumnHeaderCollection la méthode de la classe.ColumnHeader objects can be added to a ListView using the Add method of the ListView.ColumnHeaderCollection class. Pour ajouter un groupe de colonnes à un ListView, vous pouvez utiliser la AddRange méthode de la ListView.ColumnHeaderCollection classe.To add a group of columns to a ListView, you can use the AddRange method of the ListView.ColumnHeaderCollection class. Vous pouvez utiliser la Index propriété de la ColumnHeader ColumnHeader classe pour déterminer où se trouve 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.

ColumnHeaderfournit les Text propriétés TextAlign et 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 ListView contrôle, vous pouvez référencer ListView la propriété.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 ListView contrôle, vous pouvez utiliser Clone la méthode.If you want to copy a ColumnHeader for use in another ListView control, you can use the Clone method.

Constructeurs

ColumnHeader() ColumnHeader() ColumnHeader() ColumnHeader()

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

ColumnHeader(Int32) ColumnHeader(Int32) ColumnHeader(Int32) 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) ColumnHeader(String) ColumnHeader(String) 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 CanRaiseEvents CanRaiseEvents 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.

(Inherited from Component)
Container Container Container Container

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

(Inherited from Component)
DesignMode DesignMode DesignMode 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.

(Inherited from Component)
DisplayIndex DisplayIndex DisplayIndex 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 Events Events 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.

(Inherited from Component)
ImageIndex ImageIndex ImageIndex 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 ImageKey ImageKey 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 ImageList ImageList ImageList

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

Index Index Index 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 ListView ListView ListView

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

Name Name Name Name

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

Site Site Site Site

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

(Inherited from Component)
Tag Tag Tag 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 Text Text 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 TextAlign TextAlign 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 Width Width Width

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

Méthodes

AutoResize(ColumnHeaderAutoResizeStyle) AutoResize(ColumnHeaderAutoResizeStyle) AutoResize(ColumnHeaderAutoResizeStyle) 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() Clone() Clone() 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) CreateObjRef(Type) CreateObjRef(Type) 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.

(Inherited from MarshalByRefObject)
Dispose() Dispose() Dispose() Dispose()

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

(Inherited from Component)
Dispose(Boolean) Dispose(Boolean) Dispose(Boolean) 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) Equals(Object) Equals(Object) Equals(Object)

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

(Inherited from Object)
GetHashCode() GetHashCode() GetHashCode() GetHashCode()

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

(Inherited from Object)
GetLifetimeService() GetLifetimeService() GetLifetimeService() 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.

(Inherited from MarshalByRefObject)
GetService(Type) GetService(Type) GetService(Type) 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.

(Inherited from Component)
GetType() GetType() GetType() GetType()

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

(Inherited from Object)
InitializeLifetimeService() InitializeLifetimeService() InitializeLifetimeService() 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.

(Inherited from MarshalByRefObject)
MemberwiseClone() MemberwiseClone() MemberwiseClone() MemberwiseClone()

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

(Inherited from Object)
MemberwiseClone(Boolean) MemberwiseClone(Boolean) MemberwiseClone(Boolean) MemberwiseClone(Boolean)

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

(Inherited from MarshalByRefObject)
ToString() ToString() ToString() 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 Disposed Disposed 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.

(Inherited from Component)

S’applique à

Voir aussi