DataGridViewLinkColumn.CellTemplate Eigenschaft

  • Referenz

Definition

Namespace:
System.Windows.Forms
Assembly:
System.Windows.Forms.dll

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)>]
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. Der Standardwert ist eine neue Instanz von DataGridViewLinkCell.

Attribute
BrowsableAttribute

Ausnahmen

InvalidCastException

Wenn diese Eigenschaft auf einen Wert festgelegt wird, der nicht vom Typ DataGridViewLinkCell ist.

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie eine DataGridViewCell Vorlage für eine DataGridViewColumnVorlage verwendet wird. Formatänderungen, die an einer beliebigen Zelle in der Spalte vorgenommen wurden, wirken sich auf alle Zellen der Spalte aus. Dieses Codebeispiel ist Teil eines größeren Beispiels, das für die DataGridViewColumn-Klasse bereitgestellt wird.

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 DataGridViewLinkColumn Klasse initialisiert diese Eigenschaft in eine neu erstellte DataGridViewLinkCell.

Achtung

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

Gilt für

Siehe auch