DataGridViewButtonColumn クラス

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

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 コントロールのボタン列にあるボタンを無効にする