War diese Seite hilfreich?
Ihr Feedback ist uns wichtig. Teilen Sie uns Ihre Meinung mit.
Weiteres Feedback?
1500 verbleibende Zeichen
Exportieren (0) Drucken
Alle erweitern

ColumnHeader-Klasse

Zeigt einen einzelnen Spaltenkopf in einem ListView-Steuerelement an.

Namespace: System.Windows.Forms
Assembly: System.Windows.Forms (in system.windows.forms.dll)

public class ColumnHeader : Component, ICloneable
public class ColumnHeader extends Component implements ICloneable
public class ColumnHeader extends Component implements ICloneable

Ein Spaltenkopf ist ein Element in einem ListView-Steuerelement, das einen Überschriftentext enthält. ColumnHeader-Objekte fügen Sie ListView mithilfe der Add-Methode der ListView.ColumnHeaderCollection-Klasse hinzu. Um einer ListView eine Gruppe von Spalten hinzuzufügen, verwenden Sie die AddRange-Methode der ListView.ColumnHeaderCollection-Klasse. Mithilfe der Index-Eigenschaft der ColumnHeader-Klasse können Sie die Position ermitteln, an der sich der ColumnHeader in der ListView.ColumnHeaderCollection befindet.

ColumnHeader stellt die Text-Eigenschaft und die TextAlign-Eigenschaft bereit, um den im Steuerelement angezeigten Text sowie die Ausrichtung des Texts im Spaltenkopf festzulegen. Um zu bestimmen, ob ColumnHeader einem ListView-Steuerelement zugeordnet ist, können Sie auf die ListView-Eigenschaft verweisen. Wenn Sie einen ColumnHeader für die Verwendung in einem anderen ListView-Steuerelement kopieren möchten, können Sie die Clone-Methode verwenden.

Im folgenden Codebeispiel wird das Initialisieren eines ListView-Steuerelements veranschaulicht. Im Beispiel werden ColumnHeader-Objekte erstellt und die Eigenschaften Text, TextAlign und Width des Spaltenheaders festgelegt. Im Beispiel werden der ListView auch Elemente und Unterelemente hinzugefügt. Zum Ausführen dieses Beispiels fügen Sie folgenden Code in ein Formular ein, und rufen Sie die PopulateListView-Methode im Konstruktor oder im Load-Ereignishandler des Formulars auf.

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);

    // 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 void PopulateListView()
{
    listView1.set_Width(270);
    listView1.set_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.set_Text("File name");
    header1.set_TextAlign(HorizontalAlignment.Left);
    header1.set_Width(70);

    header2.set_TextAlign(HorizontalAlignment.Left);
    header2.set_Text("Location");
    header2.set_Width(200);
    // Add the headers to the ListView control.
    listView1.get_Columns().Add(header1);
    listView1.get_Columns().Add(header2);
    // 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) {
        for (int iCtr = 0; iCtr < files.length; iCtr++) {
            System.IO.FileInfo file = files[iCtr];
            ListViewItem item = new ListViewItem(file.get_Name());
            item.get_SubItems().Add(file.get_FullName());
            listView1.get_Items().Add(item);
        }
    }
} //PopulateListView

System.Object
   System.MarshalByRefObject
     System.ComponentModel.Component
      System.Windows.Forms.ColumnHeader

Alle öffentlichen statischen (Shared in Visual Basic) Member dieses Typs sind threadsicher. Bei Instanzmembern ist die Threadsicherheit nicht gewährleistet.

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile für Pocket PC, Windows Mobile für Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen.

.NET Framework

Unterstützt in: 2.0, 1.1, 1.0

.NET Compact Framework

Unterstützt in: 2.0, 1.0
Anzeigen:
© 2015 Microsoft