ColumnHeader Класс

Определение

Отображает заголовок одного столбца в элементе управления ListView.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
type ColumnHeader = class
    inherit Component
    interface ICloneable
Public Class ColumnHeader
Inherits Component
Implements ICloneable
Наследование
Атрибуты
Реализации

Примеры

В следующем примере кода демонстрируется инициализация ListView элемента управления.The following code example demonstrates initializing a ListView control. В примере создаются ColumnHeader объекты и задаются свойства Textзаголовка TextAlign столбца и Width .The example creates ColumnHeader objects and sets the column header's Text, TextAlign and Width properties. В этом примере также добавляются элементы и подэлементы ListViewв.The example also adds items and subitems to the ListView. Чтобы выполнить этот пример, вставьте следующий код в форму и вызовите PopulateListView метод из конструктора формы или Load обработчика событий.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

Комментарии

Заголовок столбца — это элемент в ListView элементе управления, который содержит текст заголовка.A column header is an item in a ListView control that contains heading text. ColumnHeaderобъекты могут быть добавлены в в ListView Add с помощью метода ListView.ColumnHeaderCollection класса.ColumnHeader objects can be added to a ListView using the Add method of the ListView.ColumnHeaderCollection class. Чтобы добавить группу столбцов в ListView, можно AddRange использовать метод ListView.ColumnHeaderCollection класса.To add a group of columns to a ListView, you can use the AddRange method of the ListView.ColumnHeaderCollection class. Index ListView.ColumnHeaderCollection СвойствоColumnHeader класса можноиспользоватьдляопределенияColumnHeader места расположения в.You can use the Index property of the ColumnHeader class to determine where the ColumnHeader is located in the ListView.ColumnHeaderCollection.

ColumnHeaderпредоставляет свойства TextAlign и для задания текста, отображаемого в элементе управления, и выравнивания текста в заголовке столбца. TextColumnHeader provides the Text and TextAlign properties to set the text displayed in the control and the alignment of the text in the column header. Чтобы определить ColumnHeader ,связанListView ли объект с элементом управления, можно использовать ссылку на свойство.ListViewTo determine whether a ColumnHeader is associated with a ListView control, you can reference the ListView property. Если требуется скопировать ColumnHeader для использования в другом ListView элементе управления Clone , можно использовать метод.If you want to copy a ColumnHeader for use in another ListView control, you can use the Clone method.

Конструкторы

ColumnHeader()

Инициализирует новый экземпляр класса ColumnHeader.Initializes a new instance of the ColumnHeader class.

ColumnHeader(Int32)

Инициализирует новый экземпляр класса ColumnHeader с указанным изображением.Initializes a new instance of the ColumnHeader class with the image specified.

ColumnHeader(String)

Инициализирует новый экземпляр класса ColumnHeader с указанным изображением.Initializes a new instance of the ColumnHeader class with the image specified.

Свойства

CanRaiseEvents

Возвращает значение, показывающее, может ли компонент вызывать событие.Gets a value indicating whether the component can raise an event.

(Унаследовано от Component)
Container

Возвращает контейнер IContainer, содержащий компонент Component.Gets the IContainer that contains the Component.

(Унаследовано от Component)
DesignMode

Возвращает значение, указывающее, находится ли данный компонент Component в режиме конструктора в настоящее время.Gets a value that indicates whether the Component is currently in design mode.

(Унаследовано от Component)
DisplayIndex

Возвращает или задает расположение столбца относительно столбцов, отображаемых в текущий момент.Gets or sets the display order of the column relative to the currently displayed columns.

Events

Возвращает список обработчиков событий, которые прикреплены к этому объекту Component.Gets the list of event handlers that are attached to this Component.

(Унаследовано от Component)
ImageIndex

Получает или задает индекс изображения, отображаемого в ColumnHeader.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

Получает список изображений, связанный с ColumnHeader.Gets the image list associated with the ColumnHeader.

Index

Получает расположение ListView этого столбца элемента управления ListView.ColumnHeaderCollection.Gets the location with the ListView control's ListView.ColumnHeaderCollection of this column.

ListView

Получает элемент управления ListView, в котором расположен ColumnHeader.Gets the ListView control the ColumnHeader is located in.

Name

Возвращает или задает имя таблицы для объекта ColumnHeader.Gets or sets the name of the ColumnHeader.

Site

Возвращает или задает ISite объекта Component.Gets or sets the ISite of the Component.

(Унаследовано от Component)
Tag

Получает или задает объект, содержащий данные, связанные с ColumnHeader.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

Получает или задает выравнивание по горизонтали текста, отображаемого в заголовке столбца ColumnHeader.Gets or sets the horizontal alignment of the text displayed in the ColumnHeader.

Width

Получает или задает ширину столбца.Gets or sets the width of the column.

Методы

AutoResize(ColumnHeaderAutoResizeStyle)

Изменяет ширину данного столбца в соответствии со стилем изменения размера.Resizes the width of the column as indicated by the resize style.

Clone()

Создает идентичную копию текущего заголовка столбца ColumnHeader, не связанную ни с одним элементом управления представления списка.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.

(Унаследовано от MarshalByRefObject)
Dispose()

Освобождает все ресурсы, занятые модулем Component.Releases all resources used by the Component.

(Унаследовано от Component)
Dispose(Boolean)

Уничтожает ресурсы (кроме памяти), используемые классом ColumnHeader.Disposes of the resources (other than memory) used by the ColumnHeader.

Equals(Object)

Определяет, равен ли указанный объект текущему объекту.Determines whether the specified object is equal to the current object.

(Унаследовано от Object)
GetHashCode()

Служит в качестве хэш-функции по умолчанию.Serves as the default hash function.

(Унаследовано от Object)
GetLifetimeService()

Извлекает объект обслуживания во время существования, который управляет политикой времени существования данного экземпляра.Retrieves the current lifetime service object that controls the lifetime policy for this instance.

(Унаследовано от MarshalByRefObject)
GetService(Type)

Возвращает объект, представляющий службу, обеспечиваемую компонентом Component или его контейнером Container.Returns an object that represents a service provided by the Component or by its Container.

(Унаследовано от Component)
GetType()

Возвращает объект Type для текущего экземпляра.Gets the Type of the current instance.

(Унаследовано от Object)
InitializeLifetimeService()

Получает объект службы времени существования для управления политикой времени существования для этого экземпляра.Obtains a lifetime service object to control the lifetime policy for this instance.

(Унаследовано от MarshalByRefObject)
MemberwiseClone()

Создает неполную копию текущего объекта Object.Creates a shallow copy of the current Object.

(Унаследовано от Object)
MemberwiseClone(Boolean)

Создает неполную копию текущего объекта MarshalByRefObject.Creates a shallow copy of the current MarshalByRefObject object.

(Унаследовано от MarshalByRefObject)
ToString()

Возвращает объект String, содержащий имя Component, если оно есть.Returns a String containing the name of the Component, if any. Этот метод не следует переопределять.This method should not be overridden.

События

Disposed

Происходит при удалении компонента вызовом метода Dispose().Occurs when the component is disposed by a call to the Dispose() method.

(Унаследовано от Component)

Применяется к

Дополнительно