DataGridViewComboBoxColumn.CellTemplate Eigenschaft

Definition

Ruft die Vorlage ab, mit deren Hilfe Zellen erstellt werden, oder legt diese fest.Gets or sets the template used to create 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; }
member this.CellTemplate : System.Windows.Forms.DataGridViewCell with get, set
Public Overrides Property CellTemplate As DataGridViewCell

Eigenschaftswert

Eine DataGridViewCell, nach der alle anderen Zellen in der Spalte erstellt werden.A DataGridViewCell that all other cells in the column are modeled after. Der Standardwert ist eine neue DataGridViewComboBoxCell.The default value is a new DataGridViewComboBoxCell.

Attribute

Ausnahmen

Wenn diese Eigenschaft auf einen Wert festgelegt wird, der nicht vom Typ DataGridViewComboBoxCell ist.When setting this property to a value that is not of type DataGridViewComboBoxCell.

Beispiele

Im folgenden Codebeispiel wird die Verwendung der DataGridViewColumn.CellTemplate-Eigenschaft veranschaulicht, die dieser Eigenschaft ähnelt.The following code example demonstrates the use of the DataGridViewColumn.CellTemplate property, which is similar to this property. Dieses Beispiel ist Teil eines größeren Beispiels, das in Gewusst wie: Bearbeiten von Spalten im Windows Forms DataGridView-SteuerElement verfügbar ist.This example is part of a larger example available in How to: Manipulate Columns in the Windows Forms DataGridView Control.

void CustomizeCellsInThirdColumn()
{
   int thirdColumn = 2;
   DataGridViewColumn^ column = dataGridView->Columns[ thirdColumn ];
   DataGridViewCell^ cell = gcnew DataGridViewTextBoxCell;
   cell->Style->BackColor = Color::Wheat;
   column->CellTemplate = cell;
}


private void CustomizeCellsInThirdColumn()
{
    int thirdColumn = 2;
    DataGridViewColumn column =
        dataGridView.Columns[thirdColumn];
    DataGridViewCell cell = new DataGridViewTextBoxCell();

    cell.Style.BackColor = Color.Wheat;
    column.CellTemplate = cell;
}
Private Sub CustomizeCellsInThirdColumn()

    Dim thirdColumn As Integer = 2
    Dim column As DataGridViewColumn = _
        dataGridView.Columns(thirdColumn)
    Dim cell As DataGridViewCell = _
        New DataGridViewTextBoxCell()

    cell.Style.BackColor = Color.Wheat
    column.CellTemplate = cell
End Sub

Hinweise

Der Konstruktor für die DataGridViewComboBoxColumn-Klasse initialisiert diese Eigenschaft mit einem neu erstellten DataGridViewComboBoxCell.The constructor for the DataGridViewComboBoxColumn class initializes this property to a newly created DataGridViewComboBoxCell.

Achtung

Das Ändern der Eigenschaften der Zellen Vorlage wirkt sich nicht direkt auf die Benutzeroberfläche (UI) der vorhandenen Zellen der Spalte aus.Changing the properties of the cell template will not immediately affect the user interface (UI) of the column's existing cells. Diese Änderungen werden erst nach der erneuten Generierung der Spalte ersichtlich (z. b. durchsortieren der Spalte oder durch einen aufzurufenden DataGridView.InvalidateColumn Methode).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).

Gilt für:

Siehe auch