Freigeben über


ColumnHeader Klasse

Definition

Zeigt einen einzelnen Spaltenkopf in einem ListView-Steuerelement an.

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
Vererbung
Attribute
Implementiert

Beispiele

Im folgenden Codebeispiel wird die Initialisierung eines ListView Steuerelements veranschaulicht. Im Beispiel werden Objekte erstellt ColumnHeader und die Eigenschaften , TextAlign und Width der TextSpaltenüberschrift festgelegt. Im Beispiel werden auch Elemente und Unterelemente zu hinzugefügt ListView. Fügen Sie zum Ausführen dieses Beispiels den folgenden Code in ein Formular ein, und rufen Sie die PopulateListView -Methode aus dem Konstruktor oder Load Ereignishandler des Formulars auf.

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

Hinweise

Eine Spaltenüberschrift ist ein Element in einem ListView Steuerelement, das Überschriftentext enthält. ColumnHeader-Objekte können mithilfe der Add -Methode der ListView.ColumnHeaderCollection -Klasse hinzugefügt ListView werden. Zum Hinzufügen einer Gruppe von Spalten zu können ListViewSie die AddRange -Methode der ListView.ColumnHeaderCollection -Klasse verwenden. Sie können die Index -Eigenschaft der ColumnHeader -Klasse verwenden, um zu bestimmen, wo sich das ColumnHeader befindet ListView.ColumnHeaderCollection.

ColumnHeader stellt die Text Eigenschaften und TextAlign bereit, um den im Steuerelement angezeigten Text und die Ausrichtung des Texts in der Spaltenüberschrift festzulegen. Um zu bestimmen, ob einem ColumnHeaderListView -Steuerelement zugeordnet ist, können Sie auf die ListView -Eigenschaft verweisen. Wenn Sie eine zur Verwendung in einem ColumnHeader anderen ListView Steuerelement kopieren möchten, können Sie die Clone -Methode verwenden.

Konstruktoren

ColumnHeader()

Initialisiert eine neue Instanz der ColumnHeader-Klasse.

ColumnHeader(Int32)

Initialisiert eine neue Instanz der ColumnHeader-Klasse mit dem angegebenen Bild.

ColumnHeader(String)

Initialisiert eine neue Instanz der ColumnHeader-Klasse mit dem angegebenen Bild.

Eigenschaften

CanRaiseEvents

Ruft einen Wert ab, der angibt, ob die Komponente ein Ereignis auslösen kann.

(Geerbt von Component)
Container

Ruft die IContainer ab, die in der Component enthalten ist.

(Geerbt von Component)
DesignMode

Ruft einen Wert ab, der angibt, ob sich Component gegenwärtig im Entwurfsmodus befindet.

(Geerbt von Component)
DisplayIndex

Ruft die Anzeigereihenfolge der Spalte relativ zu den derzeit angezeigten Spalten ab oder legt sie fest.

Events

Ruft die Liste der Ereignishandler ab, die dieser Component angefügt sind.

(Geerbt von Component)
ImageIndex

Ruft den Index des im ColumnHeader angezeigten Bilds ab oder legt diesen fest.

ImageKey

Ruft den Schlüssel des in der Spalte angezeigten Bilds ab oder legt diesen fest.

ImageList

Ruft die dem ColumnHeader zugeordnete Bildliste ab.

Index

Ruft die Position mit der ListView dieses ListView.ColumnHeaderCollection-Steuerelements für diese Spalte ab.

ListView

Ruft das ListView-Steuerelement ab, in dem sich ColumnHeader befindet.

Name

Ruft den Namen der ColumnHeader ab oder legt diesen fest.

Site

Ruft den ISite von Component ab oder legt ihn fest.

(Geerbt von Component)
Tag

Ruft das Objekt ab, das dem ColumnHeader zuzuordnende Daten enthält, oder legt dieses fest.

Text

Ruft den im Spaltenkopf angezeigten Text ab oder legt diesen fest.

TextAlign

Ruft die horizontale Ausrichtung des in ColumnHeader angezeigten Texts ab oder legt diese fest.

Width

Ruft die Breite der Spalte ab oder legt diese fest.

Methoden

AutoResize(ColumnHeaderAutoResizeStyle)

Ändert die Breite der Spalte gemäß der Formatvorlage für die Größenänderung.

Clone()

Erstellt eine identische Kopie des aktuellen ColumnHeader, die an kein Listenansicht-Steuerelement angefügt ist.

CreateObjRef(Type)

Erstellt ein Objekt mit allen relevanten Informationen, die zum Generieren eines Proxys für die Kommunikation mit einem Remoteobjekt erforderlich sind.

(Geerbt von MarshalByRefObject)
Dispose()

Gibt alle vom Component verwendeten Ressourcen frei.

(Geerbt von Component)
Dispose(Boolean)

Gibt die von der ColumnHeader-Klasse verwendeten Ressourcen (mit Ausnahme des Speichers) frei.

Equals(Object)

Bestimmt, ob das angegebene Objekt gleich dem aktuellen Objekt ist.

(Geerbt von Object)
GetHashCode()

Fungiert als Standardhashfunktion.

(Geerbt von Object)
GetLifetimeService()
Veraltet.

Ruft das aktuelle Lebensdauerdienstobjekt ab, das die Lebensdauerrichtlinien für diese Instanz steuert.

(Geerbt von MarshalByRefObject)
GetService(Type)

Gibt ein Objekt zurück, das einen von der Component oder von deren Container bereitgestellten Dienst darstellt.

(Geerbt von Component)
GetType()

Ruft den Type der aktuellen Instanz ab.

(Geerbt von Object)
InitializeLifetimeService()
Veraltet.

Ruft ein Lebensdauerdienstobjekt zur Steuerung der Lebensdauerrichtlinie für diese Instanz ab.

(Geerbt von MarshalByRefObject)
MemberwiseClone()

Erstellt eine flache Kopie des aktuellen Object.

(Geerbt von Object)
MemberwiseClone(Boolean)

Erstellt eine flache Kopie des aktuellen MarshalByRefObject-Objekts.

(Geerbt von MarshalByRefObject)
ToString()

Gibt einen String zurück, der den Namen der Component enthält (sofern vorhanden). Diese Methode darf nicht überschrieben werden.

Ereignisse

Disposed

Tritt auf, wenn die Komponente von einem Aufruf der Dispose()-Methode verworfen wird.

(Geerbt von Component)

Gilt für:

Weitere Informationen