ColumnHeader 類別

參考

定義

命名空間:: System.Windows.Forms

組件:: System.Windows.Forms.dll

重要

部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。

在 ListView 控制項中顯示單一資料行行首。

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

public 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

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

Public Class ColumnHeader
Inherits Component
Implements ICloneable

繼承: Object

MarshalByRefObject

Component
ColumnHeader

屬性: TypeConverterAttribute

實作: ICloneable

範例

下列程式碼範例示範如何初始化 ListView 控制項。此範例會 ColumnHeader 建立物件，並設定資料行標頭的 Text 、 TextAlign 和 Width 屬性。此範例也會將專案和子專案加入至 ListView 。若要執行此範例，請將下列程式碼貼到表單中，並從表單的建構函式或 Load 事件處理常式呼叫 PopulateListView 方法。

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 專案，其中包含標題文字。 ColumnHeader物件可以使用類別的 ListView.ColumnHeaderCollection 方法新增至。 Add ListView 若要將一組資料行加入至 ListView ，您可以使用 AddRange 類別的 ListView.ColumnHeaderCollection 方法。您可以使用 Index 類別的 ColumnHeader 屬性來判斷位於中的 ListView.ColumnHeaderCollection 位置 ColumnHeader 。

ColumnHeader Text提供和 TextAlign 屬性，可設定控制項中顯示的文字，以及資料行標頭中文字的對齊方式。若要判斷是否 ColumnHeader 與 ListView 控制項相關聯，您可以參考 ListView 屬性。如果您想要複製 ColumnHeader 以用於另一個 ListView 控制項，您可以使用 Clone 方法。

建構函式

ColumnHeader()	初始化 ColumnHeader 類別的新執行個體。
ColumnHeader(Int32)	使用指定的影像，初始化 ColumnHeader 類別的新執行個體。
ColumnHeader(String)	使用指定的影像，初始化 ColumnHeader 類別的新執行個體。

屬性

CanRaiseEvents	取得值，指出元件是否能引發事件。 (繼承來源 Component)
Container	取得包含 IContainer 的 Component。 (繼承來源 Component)
DesignMode	取得值，指出 Component 目前是否處於設計模式。 (繼承來源 Component)
DisplayIndex	取得或設定相對於目前所顯示之資料行的資料行顯示順序。
Events	取得附加在這個 Component 上的事件處理常式清單。 (繼承來源 Component)
ImageIndex	取得或設定顯示在 ColumnHeader 中影像的索引。
ImageKey	取得或設定顯示在資料行中影像的索引鍵。
ImageList	取得與 ColumnHeader 關聯的影像清單。
Index	取得這個資料行在 ListView 控制項之 ListView.ColumnHeaderCollection 中的位置。
ListView	取得 ListView 所在的 ColumnHeader 控制項。
Name	取得或設定 ColumnHeader 的名稱。
Site	取得或設定 Component 的 ISite。 (繼承來源 Component)
Tag	取得或設定物件，其中包含要與 ColumnHeader 產生關聯的資料。
Text	取得或設定顯示於資料行行首的文字。
TextAlign	取得或設定顯示於 ColumnHeader 中文字的水平對齊。
Width	取得或設定資料行的寬度。

方法

AutoResize(ColumnHeaderAutoResizeStyle)	根據調整大小樣式的指示，調整資料行寬度的大小。
Clone()	建立未附加至任何清單檢視控制項之目前 ColumnHeader 的同一複本。
CreateObjRef(Type)	建立包含所有相關資訊的物件，這些資訊是產生用來與遠端物件通訊的所需 Proxy。 (繼承來源 MarshalByRefObject)
Dispose()	釋放 Component 所使用的所有資源。 (繼承來源 Component)
Dispose(Boolean)	處置 (Dispose) ColumnHeader 所使用的資源 (除了記憶體之外)。
Equals(Object)	判斷指定的物件是否等於目前的物件。 (繼承來源 Object)
GetHashCode()	做為預設雜湊函式。 (繼承來源 Object)
GetLifetimeService()	已淘汰. 擷取控制這個執行個體存留期 (Lifetime) 原則的目前存留期服務物件。 (繼承來源 MarshalByRefObject)
GetService(Type)	傳回表示 Component 或其 Container 所提供之服務的物件。 (繼承來源 Component)
GetType()	取得目前執行個體的 Type。 (繼承來源 Object)
InitializeLifetimeService()	已淘汰. 取得存留期服務物件，以控制這個執行個體的存留期原則。 (繼承來源 MarshalByRefObject)
MemberwiseClone()	建立目前 Object 的淺層複製。 (繼承來源 Object)
MemberwiseClone(Boolean)	建立目前 MarshalByRefObject 物件的淺層複本。 (繼承來源 MarshalByRefObject)
ToString()	傳回任何包含 Component 名稱的 String。不應覆寫此方法。

事件

Disposed

當 Dispose() 方法的呼叫處置元件時，就會發生。

(繼承來源 Component)

適用於

共用方式為

ColumnHeader 類別

定義

範例

備註

建構函式

屬性

方法

事件

適用於

另請參閱

其他資源