ColumnHeader Osztály

Definíció

Névtér:

System.Windows.Forms

Szerelvény:

System.Windows.Forms.dll

Forrás:

ColumnHeader.cs

Egyetlen oszlopfejlécet jelenít meg egy ListView vezérlőelemben.

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

Öröklődés

Object

MarshalByRefObject

Component

ColumnHeader

Attribútumok

TypeConverterAttribute DynamicallyAccessedMembersAttribute

Megvalósítás

ICloneable

Példák

Az alábbi kód példája egy vezérlő inicializálását ListView mutatja be. A példa objektumokat hoz létre ColumnHeader , és beállítja Textaz oszlopfejlécek és TextAlignWidth -tulajdonságokat. A példa elemeket és alelemeket is hozzáad a ListView. A példa futtatásához illessze be az alábbi kódot egy űrlapba, és hívja meg a PopulateListView metódust az űrlap konstruktorából vagy Load eseménykezelőjéből.

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

Megjegyzések

Az oszlopfejléc olyan elem egy ListView vezérlőelemben, amely címsorszöveget tartalmaz. ColumnHeaderobjektumokat az osztály metódusával ListView lehet hozzáadni.AddListView.ColumnHeaderCollection Ha oszlopcsoportot szeretne hozzáadni egy ListViewcsoporthoz, használhatja az AddRangeListView.ColumnHeaderCollection osztály metódusát. Index Az osztály tulajdonságával meghatározhatjaColumnHeader, hogy hol található a ColumnHeaderListView.ColumnHeaderCollection.

ColumnHeader megadja a Text vezérlőelemben megjelenő szöveg beállításához és TextAlign az oszlopfejlécben lévő szöveg igazításához használható tulajdonságokat. Annak megállapításához, hogy egy ColumnHeader vezérlőhöz van-e társítva ListView , hivatkozhat a tulajdonságra ListView . Ha egy másik ColumnHeader vezérlőelemben való használatra szeretne másolni, ListView használhatja a metódustClone.

Konstruktorok

Name	Description
ColumnHeader()	Inicializálja a ColumnHeader osztály új példányát.
ColumnHeader(Int32)	Inicializálja az ColumnHeader osztály új példányát a megadott képpel.
ColumnHeader(String)	Inicializálja az ColumnHeader osztály új példányát a megadott képpel.

Tulajdonságok

Name	Description
DisplayIndex	Lekéri vagy beállítja az oszlop megjelenítési sorrendjét az aktuálisan megjelenített oszlopokhoz képest.
ImageIndex	Lekéri vagy beállítja a képen megjelenő ColumnHeaderkép indexét.
ImageKey	Lekéri vagy beállítja az oszlopban megjelenített kép kulcsát.
ImageList	Lekéri a képlistát a ColumnHeader.
Index	Lekéri az oszlop vezérlőjének ListView helyétListView.ColumnHeaderCollection.
ListView	Lekéri a ListView vezérlőt ColumnHeader , amelyben található.
Name	Lekéri vagy beállítja a ColumnHeadernevét.
Tag	Lekéri vagy beállítja az adatokat tartalmazó objektumot, amelyet társítani szeretne a ColumnHeader.
Text	Lekéri vagy beállítja az oszlopfejlécben megjelenő szöveget.
TextAlign	Lekéri vagy beállítja a megjelenő szöveg vízszintes igazítását.ColumnHeader
Width	Lekéri vagy beállítja az oszlop szélességét.

Metódusok

Name	Description
AutoResize(ColumnHeaderAutoResizeStyle)	Átméretezi az oszlop szélességét az átméretezés stílusa szerint.
Clone()	Létrehoz egy azonos példányt az aktuálisról ColumnHeader , amely nincs egyetlen listanézet-vezérlőhöz sem csatolva.
Dispose(Boolean)	A a rendszer által használt erőforrásokat (a memória kivételével) megsemmisíti ColumnHeader.
ToString()	String A ( ha van) nevet tartalmazó értéket Componentad vissza. Ezt a módszert nem szabad felülírni.

Lásd még

• ListView
• ListView.ColumnHeaderCollection