ColumnHeader Classe

Riferimento

Definizione

Spazio dei nomi:: System.Windows.Forms

Assembly:: System.Windows.Forms.dll

Importante

Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.

Consente di visualizzare una singola intestazione di colonna in un controllo ListView.

public ref class ColumnHeader : System::ComponentModel::Component, ICloneable

public 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

[<System.ComponentModel.TypeConverter(typeof(System.Windows.Forms.ColumnHeaderConverter))>]
type ColumnHeader = class
    inherit Component
    interface ICloneable

Public Class ColumnHeader
Inherits Component
Implements ICloneable

Ereditarietà: Object

MarshalByRefObject

Component
ColumnHeader

Attributi: TypeConverterAttribute

Implementazioni: ICloneable

Esempio

Nell'esempio di codice seguente viene illustrato l'inizializzazione di un ListView controllo. Nell'esempio vengono creati ColumnHeader oggetti e vengono impostate le proprietà e Width dell'intestazione di Text TextAlign colonna. Nell'esempio vengono aggiunti anche elementi e elementi secondari all'oggetto ListView. Per eseguire questo esempio incollare il codice seguente in un modulo e chiamare il PopulateListView metodo dal costruttore o Load dal gestore eventi del modulo.

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 contenente il testo dell'intestazione. ColumnHeader gli oggetti possono essere aggiunti a un ListView usando il Add metodo della ListView.ColumnHeaderCollection classe. Per aggiungere un gruppo di colonne a un ListViewoggetto , è possibile usare il AddRange metodo della ListView.ColumnHeaderCollection classe . È possibile usare la Index proprietà della ColumnHeader classe per determinare dove ColumnHeader si trova nell'oggetto ListView.ColumnHeaderCollection.

ColumnHeader fornisce le Text proprietà e TextAlign per impostare il testo visualizzato nel controllo e l'allineamento del testo nell'intestazione di colonna. Per determinare se un oggetto ColumnHeader è associato a un ListView controllo, è possibile fare riferimento alla ListView proprietà. Se si vuole copiare un ColumnHeader oggetto per l'uso in un altro ListView controllo, è possibile usare il Clone metodo .

Costruttori

ColumnHeader()	Inizializza una nuova istanza della classe ColumnHeader.
ColumnHeader(Int32)	Inizializza una nuova istanza della classe ColumnHeader con il tipo di immagine specificato.
ColumnHeader(String)	Inizializza una nuova istanza della classe ColumnHeader con il tipo di immagine specificato.

Proprietà

CanRaiseEvents	Ottiene un valore che indica se il componente può generare un evento. (Ereditato da Component)
Container	Ottiene l'oggetto IContainer che contiene Component. (Ereditato da Component)
DesignMode	Ottiene un valore che indica se il Component si trova in modalità progettazione. (Ereditato da Component)
DisplayIndex	Ottiene o imposta l'ordine di visualizzazione della colonna relativa alle colonne attualmente visualizzate.
Events	Ottiene l'elenco dei gestori eventi allegati a questo Component. (Ereditato da Component)
ImageIndex	Ottiene o imposta l'indice dell'immagine visualizzata nell'oggetto ColumnHeader.
ImageKey	Ottiene o imposta la chiave dell'immagine visualizzata nella colonna.
ImageList	Ottiene l'elenco delle immagini associato all'oggetto ColumnHeader.
Index	Ottiene la posizione con l'insieme ListView del controllo ListView.ColumnHeaderCollection di questa colonna.
ListView	Ottiene il controllo ListView in cui si trova l'oggetto ColumnHeader.
Name	Ottiene o imposta il nome di ColumnHeader.
Site	Ottiene o imposta l'oggetto ISite di Component. (Ereditato da Component)
Tag	Ottiene o imposta un oggetto contenente i dati da associare all'oggetto ColumnHeader.
Text	Ottiene o imposta il testo visualizzato nell'intestazione di colonna.
TextAlign	Ottiene o imposta l'allineamento orizzontale del testo visualizzato nell'oggetto ColumnHeader.
Width	Ottiene o imposta la larghezza della colonna.

Metodi

AutoResize(ColumnHeaderAutoResizeStyle)	Ridimensiona la larghezza della colonna come indicato dallo stile di ridimensionamento.
Clone()	Consente di creare una copia identica dell'oggetto ColumnHeader corrente, senza associarla ad alcun controllo visualizzazione elenco.
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. (Ereditato da MarshalByRefObject)
Dispose()	Rilascia tutte le risorse usate da Component. (Ereditato da Component)
Dispose(Boolean)	Elimina le risorse, diverse dalla memoria, usate dall'oggetto ColumnHeader.
Equals(Object)	Determina se l'oggetto specificato è uguale all'oggetto corrente. (Ereditato da Object)
GetHashCode()	Funge da funzione hash predefinita. (Ereditato da Object)
GetLifetimeService()	Obsoleti. Consente di recuperare l'oggetto servizio di durata corrente per controllare i criteri di durata per l'istanza. (Ereditato da MarshalByRefObject)
GetService(Type)	Consente di restituire un oggetto che rappresenta un servizio fornito da Component o dal relativo Container. (Ereditato da Component)
GetType()	Ottiene l'oggetto Type dell'istanza corrente. (Ereditato da Object)
InitializeLifetimeService()	Obsoleti. Ottiene un oggetto servizio di durata per controllare i criteri di durata per questa istanza. (Ereditato da MarshalByRefObject)
MemberwiseClone()	Crea una copia superficiale dell'oggetto Object corrente. (Ereditato da Object)
MemberwiseClone(Boolean)	Crea una copia dei riferimenti dell'oggetto MarshalByRefObject corrente. (Ereditato da MarshalByRefObject)
ToString()	Restituisce un oggetto String che contiene il nome dell'eventuale oggetto Component. Questo metodo non deve essere sottoposto a override.

Eventi

Disposed

Si verifica quando il componente viene eliminato da una chiamata al metodo Dispose().

(Ereditato da Component)

Si applica a

Condividi tramite