ColumnHeader クラス
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
ListView コントロールに 1 つの列ヘッダーを表示します。
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
[System.ComponentModel.TypeConverter(typeof(System.Windows.Forms.ColumnHeaderConverter))]
[System.Diagnostics.CodeAnalysis.DynamicallyAccessedMembers(System.Diagnostics.CodeAnalysis.DynamicallyAccessedMemberTypes.PublicParameterlessConstructor)]
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
[<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
- 継承
- 属性
- 実装
例
次のコード例は、 ListView コントロールの初期化を示しています。 この例では、 ColumnHeader オブジェクトを作成し、列ヘッダーの Text、 TextAlign 、および Width プロパティを設定します。 この例では、 ListViewに項目とサブ項目も追加します。 この例を実行するには、次のコードをフォームに貼り付け、フォームのコンストラクターまたはPopulateListViewイベント ハンドラーからLoad メソッドを呼び出します。
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 クラスのAdd メソッドを使用してListView.ColumnHeaderCollectionに追加できます。 ListViewに列のグループを追加するには、AddRange クラスの ListView.ColumnHeaderCollection メソッドを使用します。 Index クラスの ColumnHeader プロパティを使用して、ColumnHeaderがListView.ColumnHeaderCollection内の場所を判断できます。
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) |
| Tag |
ColumnHeaderに関連付けるデータを含むオブジェクトを取得または設定します。 |
| Text |
列ヘッダーに表示されるテキストを取得または設定します。 |
| TextAlign |
ColumnHeaderに表示されるテキストの水平方向の配置を取得または設定します。 |
| Width |
列の幅を取得または設定します。 |
メソッド
| 名前 | 説明 |
|---|---|
| AutoResize(ColumnHeaderAutoResizeStyle) |
サイズ変更スタイルで示されているように、列の幅のサイズを変更します。 |
| Clone() |
リスト ビュー コントロールにアタッチされていない現在の ColumnHeader のコピーを作成します。 |
| CreateObjRef(Type) |
リモート オブジェクトとの通信に使用されるプロキシの生成に必要なすべての関連情報を含むオブジェクトを作成します。 (継承元 MarshalByRefObject) |
| Dispose() |
Componentで使用されているすべてのリソースを解放します。 (継承元 Component) |
| Dispose(Boolean) |
ColumnHeaderによって使用される (メモリ以外の) リソースを破棄します。 |
| Equals(Object) |
指定したオブジェクトが現在のオブジェクトと等しいかどうかを判断します。 (継承元 Object) |
| GetHashCode() |
既定のハッシュ関数として機能します。 (継承元 Object) |
| GetLifetimeService() |
古い.
このインスタンスの有効期間ポリシーを制御する現在の有効期間サービス オブジェクトを取得します。 (継承元 MarshalByRefObject) |
| GetService(Type) |
ComponentまたはそのContainerによって提供されるサービスを表すオブジェクトを返します。 (継承元 Component) |
| GetType() |
現在のインスタンスの Type を取得します。 (継承元 Object) |
| InitializeLifetimeService() |
古い.
このインスタンスの有効期間ポリシーを制御する有効期間サービス オブジェクトを取得します。 (継承元 MarshalByRefObject) |
| MemberwiseClone() |
現在の Objectの簡易コピーを作成します。 (継承元 Object) |
| MemberwiseClone(Boolean) |
現在の MarshalByRefObject オブジェクトの簡易コピーを作成します。 (継承元 MarshalByRefObject) |
| ToString() |
Stringの名前 (存在する場合) を含むComponentを返します。 このメソッドはオーバーライドしないでください。 |
イベント
| 名前 | 説明 |
|---|---|
| Disposed |
コンポーネントが Dispose() メソッドの呼び出しによって破棄されるときに発生します。 (継承元 Component) |