DataGridViewImageColumn.CellTemplate Eigenschaft

Definition

Ruft die zum Erstellen neuer Zellen verwendete Vorlage ab oder legt diese fest.

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

Eigenschaftswert

Eine DataGridViewCell, nach der alle anderen Zellen in der Spalte erstellt werden.

Attribute

Ausnahmen

Der festgelegte Typ ist nicht kompatibel mit dem DataGridViewImageCell-Typ.

Beispiele

Im folgenden Codebeispiel wird die Verwendung der DataGridViewColumn.CellTemplate -Eigenschaft veranschaulicht, die dieser Eigenschaft ähnelt. Dieses Beispiel ist Teil eines größeren Beispiels, das unter Gewusst wie: Bearbeiten von Spalten im Windows Forms DataGridView-Steuerelement verfügbar ist.

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

Die Konstruktoren für die DataGridViewImageColumn -Klasse initialisieren diese Eigenschaft in einem neu erstellten DataGridViewImageCell.

Achtung

Das Ändern der Eigenschaften der Zellenvorlage wirkt sich nicht sofort auf die Benutzeroberfläche (UI) der vorhandenen Zellen der Spalte aus. Diese Änderungen werden erst sichtbar, nachdem die Spalte neu generiert wurde (z. B. durch Sortieren der Spalte oder durch einen Aufruf der DataGridView.InvalidateColumn -Methode).

Gilt für:

Weitere Informationen