DataGridViewImageColumn.DefaultCellStyle Eigenschaft

Definition

Namespace:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

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

Der von dieser Eigenschaft zurückgegebene Standardwert DataGridViewCellStyle weist die folgenden anfänglichen Eigenschaftenwerte auf:

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

Diese Werte überschreiben den in der DefaultCellStyle -Eigenschaft des DataGridView -Steuerelements angegebenen Wert, werden aber möglicherweise von anderen Zellenformateigenschaften überschrieben. 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 Zellformatobjekt auf oder Ihre eigene Fehlergrafik fest null , 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 Steuerelementeigenschaftswert AllowUserToAddRows isttrue, müssen Sie auch den Zellwert explizit auf null oder Ihre eigene Fehlergrafik in einem Handler für das Steuerelementereignis RowsAdded festlegen oder die Spalteneigenschaft CellTemplate auf einen instance eines DataGridViewImageCellabgeleiteten Typs mit einer überschriebenen DefaultNewRowValue Eigenschaft festlegen, die zurückgibtnull, oder Ihre eigene Fehlergrafik.

Wenn die NullValue Eigenschaft des von der -Eigenschaft zurückgegebenen Objekts einen Wert hat, der DefaultCellStyle der Standardfehlergrafik des Typs Bitmapentspricht, wird der ValuesAreIcons Eigenschaftswert true automatisch auf die Standardfehlergrafik des Typs IconfestgelegtNullValue. Wenn NullValue ein Wert gleich der Standardfehlergrafik des Typs Iconist, wird der ValuesAreIcons Eigenschaftswert false automatisch auf die Standardfehlergrafik des Typs BitmapfestgelegtNullValue.

Weitere Informationen

• DataGridView
• DefaultCellStyle
• DataGridViewCellStyle
• Zellstile im DataGridView-Steuerelement in Windows Forms