ColumnHeader ColumnHeader ColumnHeader ColumnHeader Class

Определение

Отображает заголовок одного столбца в элементе управления 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() ColumnHeader() ColumnHeader()

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

ColumnHeader(Int32) ColumnHeader(Int32) ColumnHeader(Int32) ColumnHeader(Int32)

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

ColumnHeader(String) ColumnHeader(String) ColumnHeader(String) ColumnHeader(String)

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

Свойства

CanRaiseEvents CanRaiseEvents CanRaiseEvents CanRaiseEvents

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

(Inherited from Component)
Container Container Container Container

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

(Inherited from Component)
DesignMode DesignMode DesignMode DesignMode

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

(Inherited from Component)
DisplayIndex DisplayIndex DisplayIndex DisplayIndex

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

Events Events Events Events

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

(Inherited from Component)
ImageIndex ImageIndex ImageIndex ImageIndex

Получает или задает индекс изображения, отображаемого в ColumnHeader.Gets or sets the index of the image displayed in the ColumnHeader.

ImageKey ImageKey ImageKey ImageKey

Получает или задает ключ изображения, отображаемого в столбце.Gets or sets the key of the image displayed in the column.

ImageList ImageList ImageList ImageList

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

Index Index Index Index

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

ListView ListView ListView ListView

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

Name Name Name Name

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

Site Site Site Site

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

(Inherited from Component)
Tag Tag Tag Tag

Получает или задает объект, содержащий данные, связанные с ColumnHeader.Gets or sets an object that contains data to associate with the ColumnHeader.

Text Text Text Text

Получает или задает текст, отображаемый в заголовке столбца.Gets or sets the text displayed in the column header.

TextAlign TextAlign TextAlign TextAlign

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

Width Width Width Width

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

Методы

AutoResize(ColumnHeaderAutoResizeStyle) AutoResize(ColumnHeaderAutoResizeStyle) AutoResize(ColumnHeaderAutoResizeStyle) AutoResize(ColumnHeaderAutoResizeStyle)

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

Clone() Clone() Clone() Clone()

Создает идентичную копию текущего заголовка столбца ColumnHeader, не связанную ни с одним элементом управления представления списка.Creates an identical copy of the current ColumnHeader that is not attached to any list view control.

CreateObjRef(Type) CreateObjRef(Type) CreateObjRef(Type) 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() Dispose() Dispose()

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

(Inherited from Component)
Dispose(Boolean) Dispose(Boolean) Dispose(Boolean) Dispose(Boolean)

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

Equals(Object) Equals(Object) Equals(Object) Equals(Object)

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

(Inherited from Object)
GetHashCode() GetHashCode() GetHashCode() GetHashCode()

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

(Inherited from Object)
GetLifetimeService() GetLifetimeService() GetLifetimeService() GetLifetimeService()

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

(Inherited from MarshalByRefObject)
GetService(Type) GetService(Type) GetService(Type) GetService(Type)

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

(Inherited from Component)
GetType() GetType() GetType() GetType()

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

(Inherited from Object)
InitializeLifetimeService() InitializeLifetimeService() InitializeLifetimeService() InitializeLifetimeService()

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

(Inherited from MarshalByRefObject)
MemberwiseClone() MemberwiseClone() MemberwiseClone() MemberwiseClone()

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

(Inherited from Object)
MemberwiseClone(Boolean) MemberwiseClone(Boolean) MemberwiseClone(Boolean) MemberwiseClone(Boolean)

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

(Inherited from MarshalByRefObject)
ToString() ToString() ToString() ToString()

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

События

Disposed Disposed Disposed Disposed

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

(Inherited from Component)

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

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