ColumnHeader Class
Displays a single column header in a ListView control.
Assembly: System.Windows.Forms (in System.Windows.Forms.dll)
System::MarshalByRefObject
System.ComponentModel::Component
System.Windows.Forms::ColumnHeader
| Name | Description | |
|---|---|---|
![]() | ColumnHeader() | Initializes a new instance of the ColumnHeader class. |
![]() | ColumnHeader(Int32) | Initializes a new instance of the ColumnHeader class with the image specified. |
![]() | ColumnHeader(String^) | Initializes a new instance of the ColumnHeader class with the image specified. |
| Name | Description | |
|---|---|---|
![]() | CanRaiseEvents | Gets a value indicating whether the component can raise an event.(Inherited from Component.) |
![]() | Container | Gets the IContainer that contains the Component.(Inherited from Component.) |
![]() | DesignMode | |
![]() | DisplayIndex | Gets or sets the display order of the column relative to the currently displayed columns. |
![]() | Events | |
![]() | ImageIndex | Gets or sets the index of the image displayed in the ColumnHeader. |
![]() | ImageKey | Gets or sets the key of the image displayed in the column. |
![]() | ImageList | Gets the image list associated with the ColumnHeader. |
![]() | Index | Gets the location with the ListView control's ListView::ColumnHeaderCollection of this column. |
![]() | ListView | Gets the ListView control the ColumnHeader is located in. |
![]() | Name | Gets or sets the name of the ColumnHeader. |
![]() | Site | |
![]() | Tag | Gets or sets an object that contains data to associate with the ColumnHeader. |
![]() | Text | Gets or sets the text displayed in the column header. |
![]() | TextAlign | Gets or sets the horizontal alignment of the text displayed in the ColumnHeader. |
![]() | Width | Gets or sets the width of the column. |
| Name | Description | |
|---|---|---|
![]() | AutoResize(ColumnHeaderAutoResizeStyle) | Resizes the width of the column as indicated by the resize style. |
![]() | Clone() | Creates an identical copy of the current ColumnHeader that is not attached to any list view control. |
![]() | CreateObjRef(Type^) | Creates an object that contains all the relevant information required to generate a proxy used to communicate with a remote object.(Inherited from MarshalByRefObject.) |
![]() | Dispose() | |
![]() | Dispose(Boolean) | Disposes of the resources (other than memory) used by the ColumnHeader.(Overrides Component::Dispose(Boolean).) |
![]() | Equals(Object^) | Determines whether the specified object is equal to the current object.(Inherited from Object.) |
![]() | Finalize() | |
![]() | GetHashCode() | Serves as the default hash function. (Inherited from Object.) |
![]() | GetLifetimeService() | Retrieves the current lifetime service object that controls the lifetime policy for this instance.(Inherited from MarshalByRefObject.) |
![]() | GetService(Type^) | |
![]() | GetType() | |
![]() | InitializeLifetimeService() | Obtains a lifetime service object to control the lifetime policy for this instance.(Inherited from MarshalByRefObject.) |
![]() | MemberwiseClone() | |
![]() | MemberwiseClone(Boolean) | Creates a shallow copy of the current MarshalByRefObject object.(Inherited from MarshalByRefObject.) |
![]() | ToString() | Returns a String containing the name of the Component, if any. This method should not be overridden.(Overrides Component::ToString().) |
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.
The following code example demonstrates initializing a ListView control. The example creates ColumnHeader objects and sets the column header's 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 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 ); } } }
Available since 1.1
Any public static ( Shared in Visual Basic) members of this type are thread safe. Any instance members are not guaranteed to be thread safe.




