DataGridViewButtonColumn

.NET Framework クラス ライブラリ リファレンス

DataGridViewButtonColumn イベント

パブリック イベント

	名前	説明
	Disposed	DataGridViewColumn が破棄されたときに発生します。 ( DataGridViewColumn から継承されます。)

参照

関連項目

DataGridViewButtonColumn クラス
System.Windows.Forms 名前空間
DataGridView クラス
DataGridViewColumn
DataGridViewRow
DataGridViewButtonCell クラス
Button クラス
DataGridViewColumn.SortMode
DataGridView.CellClick イベント

その他の技術情報

方法 : Windows フォーム DataGridView コントロールのボタン列にあるボタンを無効にする

DataGridViewButtonColumn クラス

メモ : このクラスは、.NET Framework version 2.0 で新しく追加されたものです。

DataGridViewButtonCell オブジェクトのコレクションをホストします。

名前空間: System.Windows.Forms
アセンブリ: System.Windows.Forms (system.windows.forms.dll 内)
構文

Visual Basic (宣言)

Public Class DataGridViewButtonColumn
    Inherits DataGridViewColumn

Visual Basic (使用法)

Dim instance As DataGridViewButtonColumn

C#

public class DataGridViewButtonColumn : DataGridViewColumn

C++

public ref class DataGridViewButtonColumn :
 public DataGridViewColumn

J#

public class DataGridViewButtonColumn extends
 DataGridViewColumn

JScript

public class DataGridViewButtonColumn extends
 DataGridViewColumn

解説

DataGridViewButtonColumn クラスは、DataGridViewColumn クラスの特殊な型で、単純なユーザー入力に応答するセルを論理的にホストするために使用されます。DataGridViewButtonColumn には、それと交差するすべての DataGridViewRow 内に、関連付けられた DataGridViewButtonCell があります。各セルには、Button コントロールに似たユーザー インターフェイス (UI) があります。

すべてのセルに同じボタン テキストを表示するには、UseColumnTextForButtonValue プロパティを true に設定し、Text プロパティを目的のボタン テキストに設定します。

この列型の既定の並べ替えモードは、NotSortable です。

ユーザーのボタン クリックに応答するには、DataGridView.CellContentClick イベントを処理します。

メモ
visual スタイルを有効にすると、ボタン列に含まれる各ボタンが、ButtonRenderer を使って描画されます。DefaultCellStyle などのプロパティを使って指定されたセル スタイルは無視されます。

継承時の注意 DataGridViewButtonColumn から派生したクラスに新しいプロパティを追加する場合は、Clone メソッドをオーバーライドして、クローン処理時に新しいプロパティをコピーする必要があります。また、基本クラスの Clone メソッドも呼び出して、基本クラスのプロパティが新しいセルにコピーされるようにする必要があります。

使用例

DataGridViewButtonColumn を使用して、従業員の販売成績を表示する方法を次のコード例に示します。

Visual Basic

Private Sub AddButtonColumn()
    Dim buttons As New DataGridViewButtonColumn()
    With buttons
        .HeaderText = "Sales"
        .Text = "Sales"
        .UseColumnTextForButtonValue = True
        .AutoSizeMode = DataGridViewAutoSizeColumnMode.DisplayedCells
        .FlatStyle = FlatStyle.Standard
        .CellTemplate.Style.BackColor = Color.Honeydew
        .DisplayIndex = 0
    End With

    DataGridView1.Columns.Add(buttons)

End Sub

C#

private void AddButtonColumn()
{
    DataGridViewButtonColumn buttons = new DataGridViewButtonColumn();
    {
        buttons.HeaderText = "Sales";
        buttons.Text = "Sales";
        buttons.UseColumnTextForButtonValue = true;
        buttons.AutoSizeMode =
            DataGridViewAutoSizeColumnMode.AllCells;
        buttons.FlatStyle = FlatStyle.Standard;
        buttons.CellTemplate.Style.BackColor = Color.Honeydew;
        buttons.DisplayIndex = 0;
    }

    DataGridView1.Columns.Add(buttons);

}

C++

private:
    void AddButtonColumn()
    {
        DataGridViewButtonColumn^ buttons = gcnew DataGridViewButtonColumn();
        {
            buttons->HeaderText = "Sales";
            buttons->Text = "Sales";
            buttons->UseColumnTextForButtonValue = true;
            buttons->AutoSizeMode =
                DataGridViewAutoSizeColumnMode::AllCells;
            buttons->FlatStyle = FlatStyle::Standard;
            buttons->CellTemplate->Style->BackColor = Color::Honeydew;
            buttons->DisplayIndex = 0;
        }

        DataGridView1->Columns->Add(buttons);

    }

継承階層

System.Object
   System.Windows.Forms.DataGridViewElement
     System.Windows.Forms.DataGridViewBand
       System.Windows.Forms.DataGridViewColumn
        System.Windows.Forms.DataGridViewButtonColumn

スレッド セーフ

この型の public static (Visual Basic では Shared) メンバはすべて、スレッド セーフです。インスタンス メンバの場合は、スレッド セーフであるとは限りません。

プラットフォーム

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile for Pocket PC, Windows Mobile for Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0

参照

関連項目
DataGridViewButtonColumn メンバ
System.Windows.Forms 名前空間
DataGridView クラス
DataGridViewColumn
DataGridViewRow
DataGridViewButtonCell クラス
Button クラス
DataGridViewColumn.SortMode
DataGridView.CellClick イベント
その他の技術情報
方法 : Windows フォーム DataGridView コントロールのボタン列にあるボタンを無効にする

DataGridViewButtonColumn コンストラクタ

メモ : このコンストラクタは、.NET Framework version 2.0 で新しく追加されたものです。

DataGridViewButtonColumn クラスの新しいインスタンスを既定の状態に初期化します。

名前空間: System.Windows.Forms
アセンブリ: System.Windows.Forms (system.windows.forms.dll 内)
構文

Visual Basic (宣言)

Public Sub New

Visual Basic (使用法)

Dim instance As New DataGridViewButtonColumn

C#

public DataGridViewButtonColumn ()

C++

public:
DataGridViewButtonColumn ()

J#

public DataGridViewButtonColumn ()

JScript

public function DataGridViewButtonColumn ()

解説

このコンストラクタは、次のプロパティを設定することによって列を初期化します。

プロパティ	値
CellTemplate	新しい DataGridViewButtonCell。
DefaultCellStyle プロパティによって返される DataGridViewCellStyle オブジェクトの Alignment プロパティ	DataGridViewContentAlignment.MiddleCenter

プラットフォーム

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile for Pocket PC, Windows Mobile for Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0

参照

関連項目
DataGridViewButtonColumn クラス
DataGridViewButtonColumn メンバ
System.Windows.Forms 名前空間
DataGridView クラス
CellTemplate
DataGridViewButtonCell クラス
DefaultCellStyle
DataGridViewCellStyle
DataGridViewCellStyle.Alignment

DataGridViewButtonColumn プロパティ

パブリック プロパティ

( プロテクト プロパティ も参照)

	名前	説明
	AutoSizeMode	列の幅を自動的に調整するときに使用するモードを取得または設定します。 ( DataGridViewColumn から継承されます。)
	CellTemplate	オーバーライドされます。 新しいセルの作成に使用するテンプレートを取得または設定します。
	CellType	セル テンプレートのランタイム型を取得します。 ( DataGridViewColumn から継承されます。)
	ContextMenuStrip	列のショートカット メニューを取得または設定します。 ( DataGridViewColumn から継承されます。)
	DataGridView	この要素に関連付けられている DataGridView コントロールを取得します。 ( DataGridViewElement から継承されます。)
	DataPropertyName	DataGridViewColumn がバインドされている、データ ソース プロパティの名前またはデータベースの列の名前を取得または設定します。 ( DataGridViewColumn から継承されます。)
	DefaultCellStyle	オーバーライドされます。 列の既定のセル スタイルを取得または設定します。
	DefaultHeaderCellType	既定のヘッダー セルのランタイム型を取得または設定します。 ( DataGridViewBand から継承されます。)
	Displayed	バンドが現在画面に表示されているかどうかを示す値を取得します。 ( DataGridViewBand から継承されます。)
	DisplayIndex	現在表示されている列を基準とした列の表示順序を設定または取得します。 ( DataGridViewColumn から継承されます。)
	DividerWidth	列の区分線の幅 (ピクセル数) を取得または設定します。 ( DataGridViewColumn から継承されます。)
	FillWeight	列が、コントロール内の他の塗りつぶしモードの列の幅を基準とする塗りつぶしモードの場合、列の幅を表す値を取得または設定します。 ( DataGridViewColumn から継承されます。)
	FlatStyle	列に含まれるボタン セルのフラット スタイルの外観を取得または設定します。
	Frozen	ユーザーが DataGridView コントロールを水平方向にスクロールしたときに列が移動するかどうかを示す値を取得または設定します。 ( DataGridViewColumn から継承されます。)
	HasDefaultCellStyle	DefaultCellStyle プロパティが設定されているかどうかを示す値を取得します。 ( DataGridViewBand から継承されます。)
	HeaderCell	列ヘッダーを表す DataGridViewColumnHeaderCell を取得または設定します。 ( DataGridViewColumn から継承されます。)
	HeaderText	列のヘッダー セルのキャプション テキストを取得または設定します。 ( DataGridViewColumn から継承されます。)
	Index	DataGridView コントロール内のバンドの相対位置を取得します。 ( DataGridViewBand から継承されます。)
	InheritedAutoSizeMode	列に対して有効なサイズ変更モードを取得します。 ( DataGridViewColumn から継承されます。)
	InheritedStyle	列に現在適用されているセル スタイルを取得します。 ( DataGridViewColumn から継承されます。)
	IsDataBound	列がデータ ソースにバインドされているかどうかを示す値を取得します。 ( DataGridViewColumn から継承されます。)
	MinimumWidth	列の最小幅をピクセル単位で取得または設定します。 ( DataGridViewColumn から継承されます。)
	Name	列の名前を取得または設定します。 ( DataGridViewColumn から継承されます。)
	ReadOnly	ユーザーが列のセルを編集できるかどうかを示す値を取得または設定します。 ( DataGridViewColumn から継承されます。)
	Resizable	列のサイズを変更できるかどうかを示す値を取得または設定します。 ( DataGridViewColumn から継承されます。)
	Selected	バンドが、選択されたユーザー インターフェイス (UI) 状態かどうかを示す値を取得または設定します。 ( DataGridViewBand から継承されます。)
	Site	列のサイトを取得または設定します。 ( DataGridViewColumn から継承されます。)
	SortMode	列の並べ替えモードを取得または設定します。 ( DataGridViewColumn から継承されます。)
	State	要素のユーザー インターフェイス (UI) の状態を取得します。 ( DataGridViewElement から継承されます。)
	Tag	バンドに関連付けられているデータを含むオブジェクトを取得または設定します。 ( DataGridViewBand から継承されます。)
	Text	ボタン セルに表示される既定のテキストを取得または設定します。
	ToolTipText	ツールヒントに使用されるテキストを取得または設定します。 ( DataGridViewColumn から継承されます。)
	UseColumnTextForButtonValue	Text プロパティの値が、この列に含まれるセルのボタン テキストとして表示されるかどうかを示す値を取得または設定します。
	ValueType	列のセルの値のデータ型を取得または設定します。 ( DataGridViewColumn から継承されます。)
	Visible	列を表示するかどうかを示す値を取得または設定します。 ( DataGridViewColumn から継承されます。)
	Width	列の現在の幅を取得または設定します。 ( DataGridViewColumn から継承されます。)

プロテクト プロパティ

	名前	説明
	HeaderCellCore	DataGridViewBand のヘッダー セルを取得または設定します。 ( DataGridViewBand から継承されます。)
	IsRow	バンドが行を表すかどうかを示す値を取得します。 ( DataGridViewBand から継承されます。)

参照

関連項目

DataGridViewButtonColumn クラス
System.Windows.Forms 名前空間
DataGridView クラス
DataGridViewColumn
DataGridViewRow
DataGridViewButtonCell クラス
Button クラス
DataGridViewColumn.SortMode
DataGridView.CellClick イベント

その他の技術情報

方法 : Windows フォーム DataGridView コントロールのボタン列にあるボタンを無効にする

DataGridViewButtonColumn メソッド

パブリック メソッド

( プロテクト メソッド も参照)

	名前	説明
	Clone	オーバーライドされます。 対象の列の同一コピーを作成します。
	Dispose	オーバーロードされます。 DataGridViewColumn によって使用されているすべてのリソースを解放します。 ( DataGridViewColumn から継承されます。)
	Equals	オーバーロードされます。 2 つの Object インスタンスが等しいかどうかを判断します。 ( Object から継承されます。)
	GetHashCode	特定の型のハッシュ関数として機能します。GetHashCode は、ハッシュ アルゴリズムや、ハッシュ テーブルのようなデータ構造での使用に適しています。 ( Object から継承されます。)
	GetPreferredWidth	指定した基準に基づいて、列の適切な幅を計算します。 ( DataGridViewColumn から継承されます。)
	GetType	現在のインスタンスの Type を取得します。 ( Object から継承されます。)
	ReferenceEquals	指定した複数の Object インスタンスが同一かどうかを判断します。 ( Object から継承されます。)
	ToString	オーバーライドされます。

プロテクト メソッド

	名前	説明
	Dispose	オーバーロードされます。 DataGridViewColumn によって使用されているすべてのリソースを解放します。 ( DataGridViewColumn から継承されます。)
	Finalize	バンドに関連付けられたリソースを解放します。 ( DataGridViewBand から継承されます。)
	MemberwiseClone	現在の Object の簡易コピーを作成します。 ( Object から継承されます。)
	OnDataGridViewChanged	バンドが別の DataGridView に関連付けられている場合に呼び出されます。 ( DataGridViewBand から継承されます。)
	RaiseCellClick	DataGridView.CellClick イベントを発生させます。 ( DataGridViewElement から継承されます。)
	RaiseCellContentClick	DataGridView.CellContentClick イベントを発生させます。 ( DataGridViewElement から継承されます。)
	RaiseCellContentDoubleClick	DataGridView.CellContentDoubleClick イベントを発生させます。 ( DataGridViewElement から継承されます。)
	RaiseCellValueChanged	DataGridView.CellValueChanged イベントを発生させます。 ( DataGridViewElement から継承されます。)
	RaiseDataError	DataGridView.DataError イベントを発生させます。 ( DataGridViewElement から継承されます。)
	RaiseMouseWheel	Control.MouseWheel イベントを発生させます。 ( DataGridViewElement から継承されます。)

参照

関連項目

DataGridViewButtonColumn クラス
System.Windows.Forms 名前空間
DataGridView クラス
DataGridViewColumn
DataGridViewRow
DataGridViewButtonCell クラス
Button クラス
DataGridViewColumn.SortMode
DataGridView.CellClick イベント

その他の技術情報

方法 : Windows フォーム DataGridView コントロールのボタン列にあるボタンを無効にする

DataGridViewButtonColumn メンバ

DataGridViewButtonCell オブジェクトのコレクションをホストします。

DataGridViewButtonColumn データ型で公開されるメンバを以下の表に示します。

パブリック コンストラクタ

	名前	説明
	DataGridViewButtonColumn	DataGridViewButtonColumn クラスの新しいインスタンスを既定の状態に初期化します。

パブリック プロパティ

( プロテクト プロパティ も参照)

	名前	説明
	AutoSizeMode	列の幅を自動的に調整するときに使用するモードを取得または設定します。(DataGridViewColumn から継承されます。)
	CellTemplate	オーバーライドされます。 新しいセルの作成に使用するテンプレートを取得または設定します。
	CellType	セル テンプレートのランタイム型を取得します。(DataGridViewColumn から継承されます。)
	ContextMenuStrip	列のショートカット メニューを取得または設定します。(DataGridViewColumn から継承されます。)
	DataGridView	この要素に関連付けられている DataGridView コントロールを取得します。(DataGridViewElement から継承されます。)
	DataPropertyName	DataGridViewColumn がバインドされている、データ ソース プロパティの名前またはデータベースの列の名前を取得または設定します。(DataGridViewColumn から継承されます。)
	DefaultCellStyle	オーバーライドされます。 列の既定のセル スタイルを取得または設定します。
	DefaultHeaderCellType	既定のヘッダー セルのランタイム型を取得または設定します。(DataGridViewBand から継承されます。)
	Displayed	バンドが現在画面に表示されているかどうかを示す値を取得します。 (DataGridViewBand から継承されます。)
	DisplayIndex	現在表示されている列を基準とした列の表示順序を設定または取得します。(DataGridViewColumn から継承されます。)
	DividerWidth	列の区分線の幅 (ピクセル数) を取得または設定します。(DataGridViewColumn から継承されます。)
	FillWeight	列が、コントロール内の他の塗りつぶしモードの列の幅を基準とする塗りつぶしモードの場合、列の幅を表す値を取得または設定します。(DataGridViewColumn から継承されます。)
	FlatStyle	列に含まれるボタン セルのフラット スタイルの外観を取得または設定します。
	Frozen	ユーザーが DataGridView コントロールを水平方向にスクロールしたときに列が移動するかどうかを示す値を取得または設定します。(DataGridViewColumn から継承されます。)
	HasDefaultCellStyle	DefaultCellStyle プロパティが設定されているかどうかを示す値を取得します。 (DataGridViewBand から継承されます。)
	HeaderCell	列ヘッダーを表す DataGridViewColumnHeaderCell を取得または設定します。(DataGridViewColumn から継承されます。)
	HeaderText	列のヘッダー セルのキャプション テキストを取得または設定します。(DataGridViewColumn から継承されます。)
	Index	DataGridView コントロール内のバンドの相対位置を取得します。(DataGridViewBand から継承されます。)
	InheritedAutoSizeMode	列に対して有効なサイズ変更モードを取得します。(DataGridViewColumn から継承されます。)
	InheritedStyle	列に現在適用されているセル スタイルを取得します。(DataGridViewColumn から継承されます。)
	IsDataBound	列がデータ ソースにバインドされているかどうかを示す値を取得します。(DataGridViewColumn から継承されます。)
	MinimumWidth	列の最小幅をピクセル単位で取得または設定します。(DataGridViewColumn から継承されます。)
	Name	列の名前を取得または設定します。(DataGridViewColumn から継承されます。)
	ReadOnly	ユーザーが列のセルを編集できるかどうかを示す値を取得または設定します。(DataGridViewColumn から継承されます。)
	Resizable	列のサイズを変更できるかどうかを示す値を取得または設定します。(DataGridViewColumn から継承されます。)
	Selected	バンドが、選択されたユーザー インターフェイス (UI) 状態かどうかを示す値を取得または設定します。(DataGridViewBand から継承されます。)
	Site	列のサイトを取得または設定します。(DataGridViewColumn から継承されます。)
	SortMode	列の並べ替えモードを取得または設定します。(DataGridViewColumn から継承されます。)
	State	要素のユーザー インターフェイス (UI) の状態を取得します。(DataGridViewElement から継承されます。)
	Tag	バンドに関連付けられているデータを含むオブジェクトを取得または設定します。(DataGridViewBand から継承されます。)
	Text	ボタン セルに表示される既定のテキストを取得または設定します。
	ToolTipText	ツールヒントに使用されるテキストを取得または設定します。(DataGridViewColumn から継承されます。)
	UseColumnTextForButtonValue	Text プロパティの値が、この列に含まれるセルのボタン テキストとして表示されるかどうかを示す値を取得または設定します。
	ValueType	列のセルの値のデータ型を取得または設定します。(DataGridViewColumn から継承されます。)
	Visible	列を表示するかどうかを示す値を取得または設定します。(DataGridViewColumn から継承されます。)
	Width	列の現在の幅を取得または設定します。(DataGridViewColumn から継承されます。)

プロテクト プロパティ

	名前	説明
	HeaderCellCore	DataGridViewBand のヘッダー セルを取得または設定します。(DataGridViewBand から継承されます。)
	IsRow	バンドが行を表すかどうかを示す値を取得します。(DataGridViewBand から継承されます。)

パブリック メソッド

( プロテクト メソッド も参照)

	名前	説明
	Clone	オーバーライドされます。 対象の列の同一コピーを作成します。
	Dispose	オーバーロードされます。 DataGridViewColumn によって使用されているすべてのリソースを解放します。 (DataGridViewColumn から継承されます。)
	Equals	オーバーロードされます。 2 つの Object インスタンスが等しいかどうかを判断します。 (Object から継承されます。)
	GetHashCode	特定の型のハッシュ関数として機能します。GetHashCode は、ハッシュ アルゴリズムや、ハッシュ テーブルのようなデータ構造での使用に適しています。 (Object から継承されます。)
	GetPreferredWidth	指定した基準に基づいて、列の適切な幅を計算します。 (DataGridViewColumn から継承されます。)
	GetType	現在のインスタンスの Type を取得します。 (Object から継承されます。)
	ReferenceEquals	指定した複数の Object インスタンスが同一かどうかを判断します。 (Object から継承されます。)
	ToString	オーバーライドされます。

プロテクト メソッド

	名前	説明
	Dispose	オーバーロードされます。 DataGridViewColumn によって使用されているすべてのリソースを解放します。 (DataGridViewColumn から継承されます。)
	Finalize	バンドに関連付けられたリソースを解放します。 (DataGridViewBand から継承されます。)
	MemberwiseClone	現在の Object の簡易コピーを作成します。 (Object から継承されます。)
	OnDataGridViewChanged	バンドが別の DataGridView に関連付けられている場合に呼び出されます。 (DataGridViewBand から継承されます。)
	RaiseCellClick	DataGridView.CellClick イベントを発生させます。 (DataGridViewElement から継承されます。)
	RaiseCellContentClick	DataGridView.CellContentClick イベントを発生させます。 (DataGridViewElement から継承されます。)
	RaiseCellContentDoubleClick	DataGridView.CellContentDoubleClick イベントを発生させます。 (DataGridViewElement から継承されます。)
	RaiseCellValueChanged	DataGridView.CellValueChanged イベントを発生させます。 (DataGridViewElement から継承されます。)
	RaiseDataError	DataGridView.DataError イベントを発生させます。 (DataGridViewElement から継承されます。)
	RaiseMouseWheel	Control.MouseWheel イベントを発生させます。 (DataGridViewElement から継承されます。)

パブリック イベント

	名前	説明
	Disposed	DataGridViewColumn が破棄されたときに発生します。(DataGridViewColumn から継承されます。)

参照

関連項目

DataGridViewButtonColumn クラス
System.Windows.Forms 名前空間
DataGridView クラス
DataGridViewColumn
DataGridViewRow
DataGridViewButtonCell クラス
Button クラス
DataGridViewColumn.SortMode
DataGridView.CellClick イベント

その他の技術情報

方法 : Windows フォーム DataGridView コントロールのボタン列にあるボタンを無効にする