DataGridViewButtonCell クラス

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

DataGridViewButtonCell クラス

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

DataGridView コントロールで使用する、ボタン状のユーザー インターフェイス (UI) を表示します。

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

Visual Basic (宣言)

Public Class DataGridViewButtonCell
    Inherits DataGridViewCell

Visual Basic (使用法)

Dim instance As DataGridViewButtonCell

C#

public class DataGridViewButtonCell : DataGridViewCell

C++

public ref class DataGridViewButtonCell : public
 DataGridViewCell

J#

public class DataGridViewButtonCell extends
 DataGridViewCell

JScript

public class DataGridViewButtonCell extends
 DataGridViewCell

解説

DataGridViewButtonCell クラスは、ボタン状の UI を表示するために使用される、特殊な種類の DataGridViewCell です。

DataGridViewButtonColumn は、この種類のセルを収めるための専用の列です。既存の DataGridViewButtonCell と同じセルを列内に作成するには、列の CellTemplate プロパティをそのセルに設定します。既定では、CellTemplate は新しい DataGridViewButtonCell に初期化されます。

列のセル関連プロパティは、テンプレート セルの類似した名前を持つプロパティのラッパーです。テンプレート セルのプロパティ値を変更すると、そのテンプレートをベースとするセルのうち、変更後に追加されたものにのみ変更が反映されます。一方、列のセル関連プロパティを変更すると、テンプレート セル、および列内の他のすべてのセルが更新され、必要に応じて列の表示が更新されます。

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

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

使用例

DataGridViewColumn のテンプレートとして DataGridViewCell を使用する方法のコード例を次に示します。列のセルのスタイルの変更は、その列のすべてのセルに影響します。このコード例は、DataGridViewColumn クラスのトピックで取り上げているコード例の一部分です。

Visual Basic

Private Sub CustomizeCellsInThirdColumn()

    Dim thirdColumn As Integer
 = 2
    Dim column As DataGridViewColumn = _
        dataGridView.Columns(thirdColumn)
    Dim cell As DataGridViewCell = _
        New DataGridViewTextBoxCell()

    cell.Style.BackColor = Color.Wheat
    column.CellTemplate = cell
End Sub

C#

private void CustomizeCellsInThirdColumn()
{
    int thirdColumn = 2;
    DataGridViewColumn column =
        dataGridView.Columns[thirdColumn];
    DataGridViewCell cell = new DataGridViewTextBoxCell();

    cell.Style.BackColor = Color.Wheat;
    column.CellTemplate = cell;
}

継承階層

System.Object
   System.Windows.Forms.DataGridViewElement
     System.Windows.Forms.DataGridViewCell
      System.Windows.Forms.DataGridViewButtonCell

スレッド セーフ

この型の 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

参照

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