DataGridViewButtonColumn.Text プロパティ

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

DataGridViewButtonColumn.Text プロパティ

メモ : このプロパティは、.NET Framework version 2.0 で新しく追加されたものです。

ボタン セルに表示される既定のテキストを取得または設定します。

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

Visual Basic (宣言)

Public Property Text As
 String

Visual Basic (使用法)

Dim instance As DataGridViewButtonColumn
Dim value As String

value = instance.Text

instance.Text = value

C#

public string Text { get;
 set; }

C++

public:
property String^ Text {
    String^ get ();
    void set (String^ value);
}

J#

/** @property */
public String get_Text ()

/** @property */
public void set_Text (String value)

JScript

public function get Text
 () : String

public function set Text
 (value : String)

プロパティ値
テキストを含む String。既定値は Empty です。

例外

例外の種類	条件
InvalidOperationException	このプロパティの設定時に、CellTemplate プロパティの値が null 参照 (Visual Basic では Nothing) でした。

解説

UseColumnTextForButtonValue プロパティの値が true に設定されている列に含まれる各 DataGridViewButtonCell では、Text プロパティの値がセルのボタンに表示されます。

関連付けられている DataGridView コントロールがある場合は、このプロパティを変更すると列の表示が更新されます。

使用例

DataGridViewButtonColumn を使用して、従業員の販売成績を表示する方法を次のコード例に示します。Text プロパティを使用して列ヘッダーを設定します。

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);

    }

プラットフォーム

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 クラス
DataGridViewButtonCell クラス
DataGridViewButtonCell.UseColumnTextForButtonValue プロパティ
UseColumnTextForButtonValue
DataGridViewButtonColumn.CellTemplate プロパティ