ColumnHeader-Klasse

Ein Spaltenkopf ist ein Element in einem ListView-Steuerelement, das einen Überschriftentext enthält. ColumnHeader -Objekte können einer ListView mit der Add-Methode der ListView.ColumnHeaderCollection-Klasse hinzugefügt werden. 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);

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

.NET Framework

.NET Framework Client Profile

Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (Server Core-Rolle wird nicht unterstützt), Windows Server 2008 R2 (Server Core-Rolle wird mit SP1 oder höher unterstützt; Itanium wird nicht unterstützt)

Referenz