ColumnHeader Classe

Definição

Exibe um cabeçalho de coluna única em um controle 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
public class ColumnHeader : System.ComponentModel.Component, ICloneable
type ColumnHeader = class
    inherit Component
    interface ICloneable
Public Class ColumnHeader
Inherits Component
Implements ICloneable
Herança
Atributos
Implementações

Exemplos

O exemplo de código a seguir demonstra a inicialização de um controle de ListView.The following code example demonstrates initializing a ListView control. O exemplo cria ColumnHeader objetos e define as propriedades Text, TextAlign e Width do cabeçalho da coluna.The example creates ColumnHeader objects and sets the column header's Text, TextAlign and Width properties. O exemplo também adiciona itens e subitens à ListView.The example also adds items and subitems to the ListView. Para executar este exemplo, Cole o código a seguir em um formulário e chame o método PopulateListView do construtor do formulário ou do manipulador de eventos 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

Comentários

Um cabeçalho de coluna é um item em um controle de ListView que contém o texto do cabeçalho.A column header is an item in a ListView control that contains heading text. ColumnHeader objetos podem ser adicionados a um ListView usando o método Add da classe ListView.ColumnHeaderCollection.ColumnHeader objects can be added to a ListView using the Add method of the ListView.ColumnHeaderCollection class. Para adicionar um grupo de colunas a um ListView, você pode usar o método AddRange da classe ListView.ColumnHeaderCollection.To add a group of columns to a ListView, you can use the AddRange method of the ListView.ColumnHeaderCollection class. Você pode usar a propriedade Index da classe ColumnHeader para determinar onde o ColumnHeader está localizado na ListView.ColumnHeaderCollection.You can use the Index property of the ColumnHeader class to determine where the ColumnHeader is located in the ListView.ColumnHeaderCollection.

ColumnHeader fornece as propriedades Text e TextAlign para definir o texto exibido no controle e o alinhamento do texto no cabeçalho da coluna.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. Para determinar se um ColumnHeader está associado a um controle de ListView, você pode fazer referência à propriedade ListView.To determine whether a ColumnHeader is associated with a ListView control, you can reference the ListView property. Se desejar copiar um ColumnHeader para uso em outro controle de ListView, você poderá usar o método Clone.If you want to copy a ColumnHeader for use in another ListView control, you can use the Clone method.

Construtores

ColumnHeader()

Inicializa uma nova instância da classe ColumnHeader.Initializes a new instance of the ColumnHeader class.

ColumnHeader(Int32)

Inicializa uma nova instância da classe ColumnHeader com a imagem especificada.Initializes a new instance of the ColumnHeader class with the image specified.

ColumnHeader(String)

Inicializa uma nova instância da classe ColumnHeader com a imagem especificada.Initializes a new instance of the ColumnHeader class with the image specified.

Propriedades

CanRaiseEvents

Obtém um valor que indica se o componente pode acionar um evento.Gets a value indicating whether the component can raise an event.

(Herdado de Component)
Container

Obtém o IContainer que contém o Component.Gets the IContainer that contains the Component.

(Herdado de Component)
DesignMode

Obtém um valor que indica se o Component está no modo de design no momento.Gets a value that indicates whether the Component is currently in design mode.

(Herdado de Component)
DisplayIndex

Obtém ou define a ordem de exibição da coluna em relação às colunas exibidas no momento.Gets or sets the display order of the column relative to the currently displayed columns.

Events

Obtém a lista de manipuladores de eventos que estão anexados a este Component.Gets the list of event handlers that are attached to this Component.

(Herdado de Component)
ImageIndex

Obtém ou define o índice da imagem exibida no ColumnHeader.Gets or sets the index of the image displayed in the ColumnHeader.

ImageKey

Obtém ou define a chave da imagem exibida na coluna.Gets or sets the key of the image displayed in the column.

ImageList

Obtém a lista de imagens associadas ao ColumnHeader.Gets the image list associated with the ColumnHeader.

Index

Obtém o local com o ListView.ColumnHeaderCollection do controle ListView dessa coluna.Gets the location with the ListView control's ListView.ColumnHeaderCollection of this column.

ListView

Obtém o controle ListView em que o ColumnHeader está localizado.Gets the ListView control the ColumnHeader is located in.

Name

Obtém ou define o nome de ColumnHeader.Gets or sets the name of the ColumnHeader.

Site

Obtém ou define o ISite do Component.Gets or sets the ISite of the Component.

(Herdado de Component)
Tag

Obtém ou define um objeto que contém dados a serem associados ao ColumnHeader.Gets or sets an object that contains data to associate with the ColumnHeader.

Text

Obtém ou define o texto exibido no cabeçalho da coluna.Gets or sets the text displayed in the column header.

TextAlign

Obtém ou define o alinhamento horizontal do texto exibido em ColumnHeader.Gets or sets the horizontal alignment of the text displayed in the ColumnHeader.

Width

Obtém ou define a largura da coluna.Gets or sets the width of the column.

Métodos

AutoResize(ColumnHeaderAutoResizeStyle)

Redimensiona a largura da coluna, conforme indicado pelo estilo de redimensionamento.Resizes the width of the column as indicated by the resize style.

Clone()

Cria uma cópia idêntica do ColumnHeader atual que não está anexada a nenhum controle de exibição de lista.Creates an identical copy of the current ColumnHeader that is not attached to any list view control.

CreateObjRef(Type)

Cria um objeto que contém todas as informações relevantes necessárias para gerar um proxy usado para se comunicar com um objeto remoto.Creates an object that contains all the relevant information required to generate a proxy used to communicate with a remote object.

(Herdado de MarshalByRefObject)
Dispose()

Libera todos os recursos usados pelo Component.Releases all resources used by the Component.

(Herdado de Component)
Dispose(Boolean)

Descarta os recursos (exceto a memória) usados pelo ColumnHeader.Disposes of the resources (other than memory) used by the ColumnHeader.

Equals(Object)

Determina se o objeto especificado é igual ao objeto atual.Determines whether the specified object is equal to the current object.

(Herdado de Object)
GetHashCode()

Serve como a função de hash padrão.Serves as the default hash function.

(Herdado de Object)
GetLifetimeService()

Recupera o objeto de serviço de tempo de vida atual que controla a política de ciclo de vida para esta instância.Retrieves the current lifetime service object that controls the lifetime policy for this instance.

(Herdado de MarshalByRefObject)
GetService(Type)

Retorna um objeto que representa um serviço fornecido pelo Component ou pelo seu Container.Returns an object that represents a service provided by the Component or by its Container.

(Herdado de Component)
GetType()

Obtém o Type da instância atual.Gets the Type of the current instance.

(Herdado de Object)
InitializeLifetimeService()

Obtém um objeto de serviço de tempo de vida para controlar a política de tempo de vida para essa instância.Obtains a lifetime service object to control the lifetime policy for this instance.

(Herdado de MarshalByRefObject)
MemberwiseClone()

Cria uma cópia superficial do Object atual.Creates a shallow copy of the current Object.

(Herdado de Object)
MemberwiseClone(Boolean)

Cria uma cópia superficial do objeto MarshalByRefObject atual.Creates a shallow copy of the current MarshalByRefObject object.

(Herdado de MarshalByRefObject)
ToString()

Retorna um String que contém o nome do Component, se houver.Returns a String containing the name of the Component, if any. Esse método não deve ser substituído.This method should not be overridden.

Eventos

Disposed

Ocorre quando o componente é disposto por uma chamada para o método Dispose().Occurs when the component is disposed by a call to the Dispose() method.

(Herdado de Component)

Aplica-se a

Veja também