ColumnHeader Třída

Definice

Obor názvů:

System.Windows.Forms

Sestavení:

System.Windows.Forms.dll

Zdroj:

ColumnHeader.cs

Zobrazí záhlaví jednoho sloupce v ovládacím ListView prvku.

public ref class ColumnHeader : System::ComponentModel::Component, ICloneable

[System.ComponentModel.TypeConverter(typeof(System.Windows.Forms.ColumnHeaderConverter))]
[System.Diagnostics.CodeAnalysis.DynamicallyAccessedMembers(System.Diagnostics.CodeAnalysis.DynamicallyAccessedMemberTypes.PublicParameterlessConstructor)]
public class ColumnHeader : System.ComponentModel.Component, ICloneable

[<System.ComponentModel.TypeConverter(typeof(System.Windows.Forms.ColumnHeaderConverter))>]
[<System.Diagnostics.CodeAnalysis.DynamicallyAccessedMembers(System.Diagnostics.CodeAnalysis.DynamicallyAccessedMemberTypes.PublicParameterlessConstructor)>]
type ColumnHeader = class
    inherit Component
    interface ICloneable

Public Class ColumnHeader
Inherits Component
Implements ICloneable

Dědičnost

Object

MarshalByRefObject

Component

ColumnHeader

Atributy

TypeConverterAttribute DynamicallyAccessedMembersAttribute

Implementuje

ICloneable

Příklady

Následující příklad kódu ukazuje inicializaci ListView ovládacího prvku. Příklad vytvoří ColumnHeader objekty a nastaví záhlaví TextTextAlign sloupce a Width vlastnosti. Příklad také přidá položky a dílčí položky do souboru ListView. Pokud chcete tento příklad spustit, vložte do formuláře následující kód a volejte metodu PopulateListView z konstruktoru formuláře nebo Load obslužné rutiny události.

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

Poznámky

Záhlaví sloupce je položka v ovládacím ListView prvku, který obsahuje text nadpisu. ColumnHeader objekty lze přidat do ListView metody AddListView.ColumnHeaderCollection třídy. Pokud chcete do třídy ListViewpřidat skupinu sloupců, můžete použít AddRange metodu ListView.ColumnHeaderCollection třídy. Vlastnost třídy můžete použít IndexColumnHeader k určení, kde ColumnHeader se nachází v objektu ListView.ColumnHeaderCollection.

ColumnHeader Text poskytuje a TextAlign vlastnosti pro nastavení textu zobrazeného v ovládacím prvku a zarovnání textu v záhlaví sloupce. Chcete-li zjistit, zda je přidružen k ColumnHeader ovládacímu ListView prvku, můžete odkazovat na ListView vlastnost. Pokud chcete zkopírovat použití ColumnHeader v jiném ListView ovládacím prvku, můžete použít metodu Clone .

Konstruktory

Name	Description
ColumnHeader()	Inicializuje novou instanci ColumnHeader třídy.
ColumnHeader(Int32)	Inicializuje novou instanci ColumnHeader třídy se zadaným obrázkem.
ColumnHeader(String)	Inicializuje novou instanci ColumnHeader třídy se zadaným obrázkem.

Vlastnosti

Name	Description
DisplayIndex	Získá nebo nastaví pořadí zobrazení sloupce vzhledem k aktuálně zobrazeným sloupcům.
ImageIndex	Získá nebo nastaví index obrázku zobrazeného v objektu ColumnHeader.
ImageKey	Získá nebo nastaví klíč obrázku zobrazeného ve sloupci.
ImageList	Získá seznam obrázků přidružený k .ColumnHeader
Index	Získá umístění pomocí ListView ovládacího prvku ListView.ColumnHeaderCollection tohoto sloupce.
ListView	Získá ovládací prvek ListView , ve které ColumnHeader se nachází.
Name	Získá nebo nastaví název ColumnHeader.
Tag	Získá nebo nastaví objekt, který obsahuje data, která chcete přidružit k objektu ColumnHeader.
Text	Získá nebo nastaví text zobrazený v záhlaví sloupce.
TextAlign	Získá nebo nastaví vodorovné zarovnání textu zobrazeného v souboru ColumnHeader.
Width	Získá nebo nastaví šířku sloupce.

Metody

Name	Description
AutoResize(ColumnHeaderAutoResizeStyle)	Změní šířku sloupce podle stylu změny velikosti.
Clone()	Vytvoří identickou kopii aktuální ColumnHeader kopie, která není připojena k žádnému ovládacímu prvku zobrazení seznamu.
Dispose(Boolean)	Odstraní prostředky (jiné než paměť) používané nástrojem ColumnHeader.
ToString()	String Vrátí hodnotu obsahující název Component, pokud existuje. Tato metoda by neměla být přepsána.

Viz také

• ListView
• ListView.ColumnHeaderCollection