ColumnHeader Klasse

Referenz

Definition

Namespace:: System.Windows.Forms

Assembly:: System.Windows.Forms.dll

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

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: Object

MarshalByRefObject

Component
ColumnHeader

Attribute: TypeConverterAttribute

Implementiert: ICloneable

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 ColumnHeader ListView -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: