System.Windows.Forms


.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
参照
タグ :


Page view tracker