DataGridViewButtonColumn.CellTemplate 属性

定义

获取或设置用于创建新单元格的模板。Gets or sets the template used to create new cells.

public:
 virtual property System::Windows::Forms::DataGridViewCell ^ CellTemplate { System::Windows::Forms::DataGridViewCell ^ get(); void set(System::Windows::Forms::DataGridViewCell ^ value); };
[System.ComponentModel.Browsable(false)]
public override System.Windows.Forms.DataGridViewCell CellTemplate { get; set; }
[<System.ComponentModel.Browsable(false)>]
member this.CellTemplate : System.Windows.Forms.DataGridViewCell with get, set
Public Overrides Property CellTemplate As DataGridViewCell

属性值

DataGridViewCell

一个 DataGridViewCell,列中的所有其他单元格都以它为模型。A DataGridViewCell that all other cells in the column are modeled after.

属性

例外

设置此属性时,指定值未能被强制转换为 DataGridViewButtonCellThe specified value when setting this property could not be cast to a DataGridViewButtonCell.

示例

下面的代码示例演示如何使用 DataGridViewButtonColumn 查看雇员的销售额。The following code example demonstrates how to use a DataGridViewButtonColumn to view the sales an employee has made. 单元模板用于将相同的颜色应用于所有按钮。A cell template is used to apply the same color to all buttons. 此示例是类概述主题中提供的一个更大示例的一部分 DataGridViewComboBoxColumnThis example is part of a larger example available in the DataGridViewComboBoxColumn class overview topic.

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

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

注解

类的构造函数将 DataGridViewButtonColumn 此属性初始化为新创建的 DataGridViewButtonCellThe constructor for the DataGridViewButtonColumn class initializes this property to a newly created DataGridViewButtonCell.

注意

更改单元模板的属性不会立即影响用户界面 (列的现有单元的 UI) 。Changing the properties of the cell template will not immediately affect the user interface (UI) of the column's existing cells. 这些更改仅在重新生成列后才明显 (例如,通过对列进行排序或通过对方法的调用 DataGridView.InvalidateColumn) 进行排序。These changes are only apparent after the column is regenerated (for example, by sorting the column or through a call to the DataGridView.InvalidateColumn method).

适用于

另请参阅