ColumnHeader Class
Displays a single column header in a ListView control.
For a list of all members of this type, see ColumnHeader Members.
System.Object
System.MarshalByRefObject
System.ComponentModel.Component
System.Windows.Forms.ColumnHeader
[Visual Basic] Public Class ColumnHeader Inherits Component Implements ICloneable [C#] public class ColumnHeader : Component, ICloneable [C++] public __gc class ColumnHeader : public Component, ICloneable [JScript] public class ColumnHeader extends Component implements ICloneable
Thread Safety
Any public static (Shared in Visual Basic) members of this type are thread safe. Any instance members are not guaranteed to be thread safe.
Remarks
A column header is an item in a ListView control that contains heading text. ColumnHeader objects can be added to a ListView using the Add method of the ListView.ColumnHeaderCollection class. To add a group of columns to a ListView, you can use the AddRange method of the ListView.ColumnHeaderCollection class. You can use the Index property of the ColumnHeader class to determine where the ColumnHeader is located in the ListView.ColumnHeaderCollection.
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. To determine whether a ColumnHeader is associated with a ListView control, you can reference the ListView property. If you want to copy a ColumnHeader for use in another ListView control, you can use the Clone method.
Example
[Visual Basic, C#] The following code example demonstrates initializing a ListView control. The example creates ColumnHeader objects and sets the Text, TextAlign and Width properties. The example also adds items and subitems to the ListView. To run this example paste the following code in a form and call the PopulateListView method from the form's constructor or Load method.
[Visual Basic] 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) ' 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 Not (files Is 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 [C#] 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); } } }
[C++, JScript] No example is available for C++ or JScript. To view a Visual Basic or C# example, click the Language Filter button
in the upper-left corner of the page.
Requirements
Namespace: System.Windows.Forms
Platforms: Windows 98, Windows NT 4.0, Windows Millennium Edition, Windows 2000, Windows XP Home Edition, Windows XP Professional, Windows Server 2003 family, .NET Compact Framework
Assembly: System.Windows.Forms (in System.Windows.Forms.dll)
See Also
ColumnHeader Members | System.Windows.Forms Namespace | ListView | ListView.ColumnHeaderCollection