DataGridViewButtonColumn.UseColumnTextForButtonValue プロパティ

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

DataGridViewButtonColumn.UseColumnTextForButtonValue プロパティ

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

Text プロパティの値が、この列に含まれるセルのボタン テキストとして表示されるかどうかを示す値を取得または設定します。

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

Visual Basic (宣言)

Public Property UseColumnTextForButtonValue
 As Boolean

Visual Basic (使用法)

Dim instance As DataGridViewButtonColumn
Dim value As Boolean

value = instance.UseColumnTextForButtonValue

instance.UseColumnTextForButtonValue = value

C#

public bool UseColumnTextForButtonValue { get;
 set; }

C++

public:
property bool UseColumnTextForButtonValue {
    bool get ();
    void set (bool value);
}

J#

/** @property */
public boolean get_UseColumnTextForButtonValue ()

/** @property */
public void set_UseColumnTextForButtonValue
 (boolean value)

JScript

public function get UseColumnTextForButtonValue
 () : boolean

public function set UseColumnTextForButtonValue
 (value : boolean)

プロパティ値
Text プロパティの値が列内のボタンに表示される場合は true。各セルの FormattedValue プロパティの値がボタンに表示される場合は false。既定値は false です。

例外

例外の種類	条件
InvalidOperationException	CellTemplate プロパティの値が null 参照 (Visual Basic では Nothing) です。

解説

既定では、ボタン セルの DataGridViewCell.FormattedValue がボタンのテキストとして表示されます。UseColumnTextForButtonValue プロパティを使用すると、各セルに対してボタン テキストを設定するか、Text プロパティの値をすべてのボタン セルに使用するかを決定できます。

このプロパティを取得または設定すると、CellTemplate プロパティによって返されるオブジェクトの UseColumnTextForButtonValue プロパティを取得または設定できます。このプロパティを設定すると、列に含まれるすべてのセルの UseColumnTextForButtonValue プロパティも設定され、列の表示が更新されます。各セルの指定した値をオーバーライドするには、列の値を設定してからセルの値を設定します。

使用例

このプロパティの使用方法のコード例を次に示します。

Visual Basic

Private Sub CreateUnboundButtonColumn()

    ' Initialize the button column.
    Dim buttonColumn As New
 DataGridViewButtonColumn

    With buttonColumn
        .HeaderText = "Details"
        .Name = "Details"
        .Text = "View Details"

        ' Use the Text property for the button text for all cells rather
        ' than using each cell's value as the text for its own button.
        .UseColumnTextForButtonValue = True
    End With

    ' Add the button column to the control.
    dataGridView1.Columns.Insert(1, buttonColumn)

End Sub

C#

private void CreateUnboundButtonColumn()
{
    // Initialize the button column.
    DataGridViewButtonColumn buttonColumn =
        new DataGridViewButtonColumn();
    buttonColumn.Name = "Details";
    buttonColumn.HeaderText = "Details";
    buttonColumn.Text = "View Details";

    // Use the Text property for the button text for all cells rather
    // than using each cell's value as the text for its own button.
    buttonColumn.UseColumnTextForButtonValue = true;

    // Add the button column to the control.
    dataGridView1.Columns.Insert(1, buttonColumn);
}

プラットフォーム

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 クラス
DataGridViewButtonColumn.Text プロパティ
DataGridViewCell.FormattedValue
DataGridViewButtonColumn.CellTemplate プロパティ
DataGridViewButtonCell クラス
DataGridViewButtonCell.UseColumnTextForButtonValue プロパティ
その他の技術情報
方法 : Windows フォーム DataGridView コントロールのボタン列にあるボタンを無効にする