ColumnHeader Classe

Definizione

Consente di visualizzare una singola intestazione di colonna in un controllo 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
public class ColumnHeader : System.ComponentModel.Component, ICloneable
[<System.ComponentModel.TypeConverter(typeof(System.Windows.Forms.ColumnHeaderConverter))>]
type ColumnHeader = class
    inherit Component
    interface ICloneable
type ColumnHeader = class
    inherit Component
    interface ICloneable
Public Class ColumnHeader
Inherits Component
Implements ICloneable
Ereditarietà
Attributi
Implementazioni

Esempio

Nell'esempio di codice seguente viene illustrata l'inizializzazione di un ListView controllo.The following code example demonstrates initializing a ListView control. Nell'esempio vengono creati ColumnHeader oggetti e vengono impostate le Text proprietà, TextAlign e dell'intestazione di colonna Width .The example creates ColumnHeader objects and sets the column header's Text, TextAlign and Width properties. Nell'esempio vengono inoltre aggiunti elementi e elementi secondari a ListView .The example also adds items and subitems to the ListView. Per eseguire questo esempio, incollare il codice seguente in un form e chiamare il PopulateListView metodo dal costruttore del form o dal Load gestore eventi.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

Commenti

Un'intestazione di colonna è un elemento in un ListView controllo che contiene il testo dell'intestazione.A column header is an item in a ListView control that contains heading text. ColumnHeader gli oggetti possono essere aggiunti a un oggetto ListView utilizzando il Add metodo della ListView.ColumnHeaderCollection classe.ColumnHeader objects can be added to a ListView using the Add method of the ListView.ColumnHeaderCollection class. Per aggiungere un gruppo di colonne a un oggetto ListView , è possibile usare il AddRange metodo della ListView.ColumnHeaderCollection classe.To add a group of columns to a ListView, you can use the AddRange method of the ListView.ColumnHeaderCollection class. È possibile utilizzare la Index proprietà della ColumnHeader classe per determinare la posizione ColumnHeader in cui si trova l'oggetto ListView.ColumnHeaderCollection .You can use the Index property of the ColumnHeader class to determine where the ColumnHeader is located in the ListView.ColumnHeaderCollection.

ColumnHeader fornisce le Text TextAlign proprietà e per impostare il testo visualizzato nel controllo e l'allineamento del testo nell'intestazione di colonna.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. Per determinare se un oggetto ColumnHeader è associato a un ListView controllo, è possibile fare riferimento alla ListView Proprietà.To determine whether a ColumnHeader is associated with a ListView control, you can reference the ListView property. Se si desidera copiare un oggetto ColumnHeader da utilizzare in un altro ListView controllo, è possibile utilizzare il Clone metodo.If you want to copy a ColumnHeader for use in another ListView control, you can use the Clone method.

Costruttori

ColumnHeader()

Inizializza una nuova istanza della classe ColumnHeader.Initializes a new instance of the ColumnHeader class.

ColumnHeader(Int32)

Inizializza una nuova istanza della classe ColumnHeader con il tipo di immagine specificato.Initializes a new instance of the ColumnHeader class with the image specified.

ColumnHeader(String)

Inizializza una nuova istanza della classe ColumnHeader con il tipo di immagine specificato.Initializes a new instance of the ColumnHeader class with the image specified.

Proprietà

CanRaiseEvents

Ottiene un valore che indica se il componente può generare un evento.Gets a value indicating whether the component can raise an event.

(Ereditato da Component)
Container

Ottiene l'oggetto IContainer che contiene Component.Gets the IContainer that contains the Component.

(Ereditato da Component)
DesignMode

Ottiene un valore che indica se il Component si trova in modalità progettazione.Gets a value that indicates whether the Component is currently in design mode.

(Ereditato da Component)
DisplayIndex

Ottiene o imposta l'ordine di visualizzazione della colonna relativa alle colonne attualmente visualizzate.Gets or sets the display order of the column relative to the currently displayed columns.

Events

Ottiene l'elenco dei gestori eventi allegati a questo Component.Gets the list of event handlers that are attached to this Component.

(Ereditato da Component)
ImageIndex

Ottiene o imposta l'indice dell'immagine visualizzata nell'oggetto ColumnHeader.Gets or sets the index of the image displayed in the ColumnHeader.

ImageKey

Ottiene o imposta la chiave dell'immagine visualizzata nella colonna.Gets or sets the key of the image displayed in the column.

ImageList

Ottiene l'elenco delle immagini associato all'oggetto ColumnHeader.Gets the image list associated with the ColumnHeader.

Index

Ottiene la posizione con l'insieme ListView del controllo ListView.ColumnHeaderCollection di questa colonna.Gets the location with the ListView control's ListView.ColumnHeaderCollection of this column.

ListView

Ottiene il controllo ListView in cui si trova l'oggetto ColumnHeader.Gets the ListView control the ColumnHeader is located in.

Name

Ottiene o imposta il nome di ColumnHeader.Gets or sets the name of the ColumnHeader.

Site

Ottiene o imposta l'oggetto ISite di Component.Gets or sets the ISite of the Component.

(Ereditato da Component)
Tag

Ottiene o imposta un oggetto contenente i dati da associare all'oggetto ColumnHeader.Gets or sets an object that contains data to associate with the ColumnHeader.

Text

Ottiene o imposta il testo visualizzato nell'intestazione di colonna.Gets or sets the text displayed in the column header.

TextAlign

Ottiene o imposta l'allineamento orizzontale del testo visualizzato nell'oggetto ColumnHeader.Gets or sets the horizontal alignment of the text displayed in the ColumnHeader.

Width

Ottiene o imposta la larghezza della colonna.Gets or sets the width of the column.

Metodi

AutoResize(ColumnHeaderAutoResizeStyle)

Ridimensiona la larghezza della colonna come indicato dallo stile di ridimensionamento.Resizes the width of the column as indicated by the resize style.

Clone()

Consente di creare una copia identica dell'oggetto ColumnHeader corrente, senza associarla ad alcun controllo visualizzazione elenco.Creates an identical copy of the current ColumnHeader that is not attached to any list view control.

CreateObjRef(Type)

Consente di creare un oggetto che contiene tutte le informazioni rilevanti necessarie per la generazione del proxy utilizzato per effettuare la comunicazione con un oggetto remoto.Creates an object that contains all the relevant information required to generate a proxy used to communicate with a remote object.

(Ereditato da MarshalByRefObject)
Dispose()

Rilascia tutte le risorse usate da Component.Releases all resources used by the Component.

(Ereditato da Component)
Dispose(Boolean)

Elimina le risorse, diverse dalla memoria, usate dall'oggetto ColumnHeader.Disposes of the resources (other than memory) used by the ColumnHeader.

Equals(Object)

Determina se l'oggetto specificato è uguale all'oggetto corrente.Determines whether the specified object is equal to the current object.

(Ereditato da Object)
GetHashCode()

Funge da funzione hash predefinita.Serves as the default hash function.

(Ereditato da Object)
GetLifetimeService()
Obsoleta.

Consente di recuperare l'oggetto servizio di durata corrente per controllare i criteri di durata per l'istanza.Retrieves the current lifetime service object that controls the lifetime policy for this instance.

(Ereditato da MarshalByRefObject)
GetService(Type)

Consente di restituire un oggetto che rappresenta un servizio fornito da Component o dal relativo Container.Returns an object that represents a service provided by the Component or by its Container.

(Ereditato da Component)
GetType()

Ottiene l'oggetto Type dell'istanza corrente.Gets the Type of the current instance.

(Ereditato da Object)
InitializeLifetimeService()
Obsoleta.

Ottiene un oggetto servizio di durata per controllare i criteri di durata per questa istanza.Obtains a lifetime service object to control the lifetime policy for this instance.

(Ereditato da MarshalByRefObject)
MemberwiseClone()

Crea una copia superficiale dell'oggetto Object corrente.Creates a shallow copy of the current Object.

(Ereditato da Object)
MemberwiseClone(Boolean)

Crea una copia dei riferimenti dell'oggetto MarshalByRefObject corrente.Creates a shallow copy of the current MarshalByRefObject object.

(Ereditato da MarshalByRefObject)
ToString()

Restituisce un oggetto String che contiene il nome dell'eventuale oggetto Component.Returns a String containing the name of the Component, if any. Questo metodo non deve essere sottoposto a override.This method should not be overridden.

Eventi

Disposed

Si verifica quando il componente viene eliminato da una chiamata al metodo Dispose().Occurs when the component is disposed by a call to the Dispose() method.

(Ereditato da Component)

Si applica a

Vedi anche