DataGridViewImageColumn.DefaultCellStyle Eigenschaft
Definition
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 Standardzellenformatvorlage der Spalte ab oder legt sie 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, setPublic Overrides Property DefaultCellStyle As DataGridViewCellStyleEigenschaftswert
Die DataGridViewCellStyle als Standardformatvorlage angewendet werden soll.
- Attribute
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 Standardeigenschaft DataGridViewCellStyle weist die folgenden anfänglichen Eigenschaftswerte auf:
DataGridViewCellStyle-Eigenschaft |
Standardwert |
|---|---|
| Alignment | DataGridViewContentAlignment.MiddleCenter |
| NullValue | Eine Standardfehlergrafik des Typs Icon , wenn der anfängliche ValuesAreIcons Eigenschaftswert lautet true; andernfalls eine Standardfehlergrafik vom Typ Bitmap. |
Diese Werte setzen den in der DefaultCellStyle Eigenschaft des DataGridView Steuerelements angegebenen Wert außer Kraft, können jedoch von anderen Zellenformateigenschaften überschrieben werden. Weitere Informationen finden Sie unter "Zellenformatvorlagen" im Windows Forms DataGridView-Steuerelement.
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 eine 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 AllowUserToAddRows lautet true, 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 eine Instanz eines DataGridViewImageCellabgeleiteten Typs mit einer überschriebenen DefaultNewRowValue Eigenschaft festlegen, die zurückgegeben null wird oder ihre eigene Fehlergrafik.
Wenn die NullValue Eigenschaft des von der DefaultCellStyle Eigenschaft zurückgegebenen Objekts einen Wert aufweist, der der Standardfehlergrafik des Typs Bitmapentspricht, wird der Eigenschaftswert true so geändert, dass er ValuesAreIcons automatisch auf die Standardfehlergrafik des Typs Iconfestgelegt wirdNullValue. Wenn NullValue ein Wert gleich der Standardfehlergrafik des Typs Iconist, wird der ValuesAreIcons Eigenschaftswert false so geändert, dass er automatisch auf die Standardfehlergrafik des Typs Bitmapfestgelegt wirdNullValue.
