ColumnHeader Klasse

Definition

Zeigt einen einzelnen Spaltenkopf in einem ListView-Steuerelement an.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
Vererbung
Attribute
Implementiert

Beispiele

Im folgenden Codebeispiel wird die Initialisierung eines-Steuer Elements veranschaulicht ListView .The following code example demonstrates initializing a ListView control. Im Beispiel ColumnHeader werden-Objekte erstellt und die-,-und-Eigenschaften des Spalten Headers festgelegt Text TextAlign Width .The example creates ColumnHeader objects and sets the column header's Text, TextAlign and Width properties. Im Beispiel werden auch Elemente und unter Elemente hinzugefügt ListView .The example also adds items and subitems to the ListView. Fügen Sie zum Ausführen dieses Beispiels den folgenden Code in ein Formular ein, und nennen Sie die PopulateListView -Methode aus dem Konstruktor oder Load Ereignishandler des Formulars.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

Hinweise

Eine Spaltenüberschrift ist ein Element in einem ListView Steuerelement, das Überschrift Text enthält.A column header is an item in a ListView control that contains heading text. ColumnHeader -Objekte können einem ListView mithilfe der- Add Methode der-Klasse hinzugefügt werden ListView.ColumnHeaderCollection .ColumnHeader objects can be added to a ListView using the Add method of the ListView.ColumnHeaderCollection class. Wenn Sie einer eine Gruppe von Spalten hinzufügen möchten ListView , können Sie die- AddRange Methode der- ListView.ColumnHeaderCollection Klasse verwenden.To add a group of columns to a ListView, you can use the AddRange method of the ListView.ColumnHeaderCollection class. Sie können die- Index Eigenschaft der- ColumnHeader Klasse verwenden, um zu bestimmen, wo sich das ColumnHeader in der befindet ListView.ColumnHeaderCollection .You can use the Index property of the ColumnHeader class to determine where the ColumnHeader is located in the ListView.ColumnHeaderCollection.

ColumnHeader stellt die Text -Eigenschaft und die-Eigenschaft bereit TextAlign , um den im-Steuerelement angezeigten Text und die Ausrichtung des Texts im Spaltenheader festzulegen.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. Um zu ermitteln, ob ein einem- ColumnHeader Steuerelement zugeordnet ist ListView , können Sie auf die- ListView Eigenschaft verweisen.To determine whether a ColumnHeader is associated with a ListView control, you can reference the ListView property. Wenn Sie ein-Element ColumnHeader für die Verwendung in einem anderen Steuerelement kopieren möchten ListView , können Sie die- Clone Methode verwenden.If you want to copy a ColumnHeader for use in another ListView control, you can use the Clone method.

Konstruktoren

ColumnHeader()

Initialisiert eine neue Instanz der ColumnHeader-Klasse.Initializes a new instance of the ColumnHeader class.

ColumnHeader(Int32)

Initialisiert eine neue Instanz der ColumnHeader-Klasse mit dem angegebenen Bild.Initializes a new instance of the ColumnHeader class with the image specified.

ColumnHeader(String)

Initialisiert eine neue Instanz der ColumnHeader-Klasse mit dem angegebenen Bild.Initializes a new instance of the ColumnHeader class with the image specified.

Eigenschaften

CanRaiseEvents

Ruft einen Wert ab, der angibt, ob die Komponente ein Ereignis auslösen kann.Gets a value indicating whether the component can raise an event.

(Geerbt von Component)
Container

Ruft die IContainer ab, die in der Component enthalten ist.Gets the IContainer that contains the Component.

(Geerbt von Component)
DesignMode

Ruft einen Wert ab, der angibt, ob sich Component gegenwärtig im Entwurfsmodus befindet.Gets a value that indicates whether the Component is currently in design mode.

(Geerbt von Component)
DisplayIndex

Ruft die Anzeigereihenfolge der Spalte relativ zu den derzeit angezeigten Spalten ab oder legt sie fest.Gets or sets the display order of the column relative to the currently displayed columns.

Events

Ruft die Liste der Ereignishandler ab, die dieser Component angefügt sind.Gets the list of event handlers that are attached to this Component.

(Geerbt von Component)
ImageIndex

Ruft den Index des im ColumnHeader angezeigten Bilds ab oder legt diesen fest.Gets or sets the index of the image displayed in the ColumnHeader.

ImageKey

Ruft den Schlüssel des in der Spalte angezeigten Bilds ab oder legt diesen fest.Gets or sets the key of the image displayed in the column.

ImageList

Ruft die dem ColumnHeader zugeordnete Bildliste ab.Gets the image list associated with the ColumnHeader.

Index

Ruft die Position mit der ListView dieses ListView.ColumnHeaderCollection-Steuerelements für diese Spalte ab.Gets the location with the ListView control's ListView.ColumnHeaderCollection of this column.

ListView

Ruft das ListView-Steuerelement ab, in dem sich ColumnHeader befindet.Gets the ListView control the ColumnHeader is located in.

Name

Ruft den Namen der ColumnHeader ab oder legt diesen fest.Gets or sets the name of the ColumnHeader.

Site

Ruft den ISite von Component ab oder legt ihn fest.Gets or sets the ISite of the Component.

(Geerbt von Component)
Tag

Ruft das Objekt ab, das dem ColumnHeader zuzuordnende Daten enthält, oder legt dieses fest.Gets or sets an object that contains data to associate with the ColumnHeader.

Text

Ruft den im Spaltenkopf angezeigten Text ab oder legt diesen fest.Gets or sets the text displayed in the column header.

TextAlign

Ruft die horizontale Ausrichtung des in ColumnHeader angezeigten Texts ab oder legt diese fest.Gets or sets the horizontal alignment of the text displayed in the ColumnHeader.

Width

Ruft die Breite der Spalte ab oder legt diese fest.Gets or sets the width of the column.

Methoden

AutoResize(ColumnHeaderAutoResizeStyle)

Ändert die Breite der Spalte gemäß der Formatvorlage für die Größenänderung.Resizes the width of the column as indicated by the resize style.

Clone()

Erstellt eine identische Kopie des aktuellen ColumnHeader, die an kein Listenansicht-Steuerelement angefügt ist.Creates an identical copy of the current ColumnHeader that is not attached to any list view control.

CreateObjRef(Type)

Erstellt ein Objekt mit allen relevanten Informationen, die zum Generieren eines Proxys für die Kommunikation mit einem Remoteobjekt erforderlich sind.Creates an object that contains all the relevant information required to generate a proxy used to communicate with a remote object.

(Geerbt von MarshalByRefObject)
Dispose()

Gibt alle vom Component verwendeten Ressourcen frei.Releases all resources used by the Component.

(Geerbt von Component)
Dispose(Boolean)

Gibt die von der ColumnHeader-Klasse verwendeten Ressourcen (mit Ausnahme des Speichers) frei.Disposes of the resources (other than memory) used by the ColumnHeader.

Equals(Object)

Bestimmt, ob das angegebene Objekt gleich dem aktuellen Objekt ist.Determines whether the specified object is equal to the current object.

(Geerbt von Object)
GetHashCode()

Fungiert als Standardhashfunktion.Serves as the default hash function.

(Geerbt von Object)
GetLifetimeService()
Veraltet.

Ruft das aktuelle Lebensdauerdienstobjekt ab, das die Lebensdauerrichtlinien für diese Instanz steuert.Retrieves the current lifetime service object that controls the lifetime policy for this instance.

(Geerbt von MarshalByRefObject)
GetService(Type)

Gibt ein Objekt zurück, das einen von der Component oder von deren Container bereitgestellten Dienst darstellt.Returns an object that represents a service provided by the Component or by its Container.

(Geerbt von Component)
GetType()

Ruft den Type der aktuellen Instanz ab.Gets the Type of the current instance.

(Geerbt von Object)
InitializeLifetimeService()
Veraltet.

Ruft ein Lebensdauerdienstobjekt zur Steuerung der Lebensdauerrichtlinie für diese Instanz ab.Obtains a lifetime service object to control the lifetime policy for this instance.

(Geerbt von MarshalByRefObject)
MemberwiseClone()

Erstellt eine flache Kopie des aktuellen Object.Creates a shallow copy of the current Object.

(Geerbt von Object)
MemberwiseClone(Boolean)

Erstellt eine flache Kopie des aktuellen MarshalByRefObject-Objekts.Creates a shallow copy of the current MarshalByRefObject object.

(Geerbt von MarshalByRefObject)
ToString()

Gibt einen String zurück, der den Namen der Component enthält (sofern vorhanden).Returns a String containing the name of the Component, if any. Diese Methode darf nicht überschrieben werden.This method should not be overridden.

Ereignisse

Disposed

Tritt auf, wenn die Komponente von einem Aufruf der Dispose()-Methode verworfen wird.Occurs when the component is disposed by a call to the Dispose() method.

(Geerbt von Component)

Gilt für:

Siehe auch