DataGridViewTextBoxColumn.CellTemplate Eigenschaft

Referenz

Definition

Namespace:: System.Windows.Forms

Assembly:: System.Windows.Forms.dll

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Ruft die zum Gestalten der Zellendarstellung 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)>]
member this.CellTemplate : System.Windows.Forms.DataGridViewCell with get, set

Public Overrides Property CellTemplate As DataGridViewCell

Eigenschaftswert

DataGridViewCell

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

Attribute: BrowsableAttribute

Ausnahmen

InvalidCastException

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

Beispiele

Im folgenden Codebeispiel wird die Verwendung der DataGridViewColumn.CellTemplate Eigenschaft veranschaulicht, die ähnlich wie diese Eigenschaft ist. In diesem Beispiel handelt es sich um ein größeres Beispiel, das in "How to" verfügbar ist: Bearbeiten von Spalten im Windows Forms DataGridView-Steuerelement.

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 DataGridViewTextBoxColumn Klasse initialisiert diese Eigenschaft auf eine neu erstellte DataGridViewTextBoxCell.

Achtung

Das Ändern der Eigenschaften der Zellvorlage wirkt sich nicht sofort auf die Benutzeroberfläche der vorhandenen Zellen der Spalte aus. Diese Änderungen werden nur angezeigt, nachdem die Spalte neu generiert wird (z. B. durch Sortieren der Spalte oder durch einen Aufruf der DataGridView.InvalidateColumn Methode).

Gilt für

Freigeben über