DataGridViewImageColumn.DefaultCellStyle 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 das Standardzellenformat der Spalte ab oder legt dieses fest.

public:
 virtual property System::Windows::Forms::DataGridViewCellStyle ^ DefaultCellStyle { System::Windows::Forms::DataGridViewCellStyle ^ get(); void set(System::Windows::Forms::DataGridViewCellStyle ^ value); };

[System.ComponentModel.Browsable(true)]
public override System.Windows.Forms.DataGridViewCellStyle DefaultCellStyle { get; set; }

[<System.ComponentModel.Browsable(true)>]
member this.DefaultCellStyle : System.Windows.Forms.DataGridViewCellStyle with get, set

Public Overrides Property DefaultCellStyle As DataGridViewCellStyle

Eigenschaftswert

DataGridViewCellStyle

Das DataGridViewCellStyle, das als Standardformat übernommen werden soll.

Attribute: BrowsableAttribute

Beispiele

Im folgenden Codebeispiel wird die Verwendung dieser Eigenschaft veranschaulicht.

private void ChangeColumnAlignment()
{
    songsDataGridView.Columns["Title"].DefaultCellStyle.Alignment = DataGridViewContentAlignment.BottomCenter;
    songsDataGridView.Columns["Title"].Name = DataGridViewContentAlignment.BottomCenter.ToString();

    songsDataGridView.Columns["Artist"].DefaultCellStyle.Alignment = DataGridViewContentAlignment.BottomLeft;
    songsDataGridView.Columns["Artist"].Name = DataGridViewContentAlignment.BottomLeft.ToString();

    songsDataGridView.Columns["Album"].DefaultCellStyle.Alignment = DataGridViewContentAlignment.BottomRight;
    songsDataGridView.Columns["Album"].Name = DataGridViewContentAlignment.BottomRight.ToString();

    songsDataGridView.Columns["Release Date"].DefaultCellStyle.Alignment = DataGridViewContentAlignment.MiddleCenter;
    songsDataGridView.Columns["Release Date"].Name = DataGridViewContentAlignment.MiddleCenter.ToString();

    songsDataGridView.Columns["Track"].DefaultCellStyle.Alignment = DataGridViewContentAlignment.MiddleLeft;
    songsDataGridView.Columns["Track"].Name = DataGridViewContentAlignment.MiddleLeft.ToString();
}

Private Sub ChangeColumnAlignment()
    songsDataGridView.Columns("Title").DefaultCellStyle.Alignment = DataGridViewContentAlignment.BottomCenter
    songsDataGridView.Columns("Title").Name = DataGridViewContentAlignment.BottomCenter.ToString()

    songsDataGridView.Columns("Artist").DefaultCellStyle.Alignment = DataGridViewContentAlignment.BottomLeft
    songsDataGridView.Columns("Artist").Name = DataGridViewContentAlignment.BottomLeft.ToString()

    songsDataGridView.Columns("Album").DefaultCellStyle.Alignment = DataGridViewContentAlignment.BottomRight
    songsDataGridView.Columns("Album").Name = DataGridViewContentAlignment.BottomRight.ToString()

    songsDataGridView.Columns("Release Date").DefaultCellStyle.Alignment = DataGridViewContentAlignment.MiddleCenter
    songsDataGridView.Columns("Release Date").Name = DataGridViewContentAlignment.MiddleCenter.ToString()

    songsDataGridView.Columns("Track").DefaultCellStyle.Alignment = DataGridViewContentAlignment.MiddleLeft
    songsDataGridView.Columns("Track").Name = DataGridViewContentAlignment.MiddleLeft.ToString()
End Sub

Hinweise

Die von dieser Eigenschaft zurückgegebene Standard DataGridViewCellStyle hat die folgenden anfänglichen Eigenschaftswerte:

`DataGridViewCellStyle` -Eigenschaft	Standardwert
Alignment	DataGridViewContentAlignment.MiddleCenter
NullValue	Eine Standardfehlergrafik vom Typ Icon , wenn der anfängliche ValuesAreIcons Eigenschaftswert lautet `true`; andernfalls eine Standardfehlergrafik vom Typ Bitmap.

Diese Werte überschreiben den wert, der in der DefaultCellStyle Eigenschaft des DataGridView Steuerelements angegeben ist, kann jedoch von anderen Zellenformateigenschaften außer Kraft gesetzt werden. Weitere Informationen finden Sie unter Zellenstile im DataGridView-Steuerelement in Windows Forms.

Um zu verhindern, dass die Standardfehlergrafik für null oder DBNull.Value Zellwerte angezeigt wird, legen Sie die DataGridViewCellStyle.NullValue Eigenschaft für dieses Zellenformatobjekt auf null oder ihre eigene Fehlergrafik fest, bevor Sie dem Steuerelement Zeilen hinzufügen. Dies wirkt sich jedoch nicht auf die Zeile für neue Datensätze aus. Um zu verhindern, dass die Fehlergrafik in der Zeile für neue Datensätze angezeigt wird, wenn der Wert der Steuerelementeigenschaft lautet, müssen Sie auch explizit den Zellwert null auf oder ihre eigene Fehlergrafik in einem Handler für das Steuerelementereignis RowsAdded festlegen oder die Spalteneigenschaft CellTemplate auf eine Instanz eines DataGridViewImageCellabgeleiteten Typs mit einer überschriebenen DefaultNewRowValue Eigenschaft festlegen, die oder ihre eigene Fehlergrafik zurückgibtnull.trueAllowUserToAddRows

Wenn die NullValue Eigenschaft des von der DefaultCellStyle Eigenschaft zurückgegebenen Objekts einen Wert hat, der der Standardfehlergrafik des Typs Bitmapentspricht, wird der Eigenschaftswert so geändert, dass true automatisch ValuesAreIcons die Standardfehlergrafik des Typs Iconfestgelegt wirdNullValue. Wenn NullValue ein Wert gleich der Standardfehlergrafik des Typs Iconist, wird der ValuesAreIcons Eigenschaftswert so geändert, dass false er automatisch auf die Standardfehlergrafik des Typs Bitmapfestgelegt wirdNullValue.

Gilt für: