DataGridViewCellStyle Klasse

Definition

Namespace:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Quelle:

DataGridViewCellStyle.cs

Stellt die Formatierung und die Stilinformationen dar, die auf einzelne Zellen in einem DataGridView-Steuerelement angewendet wurden.

[System.ComponentModel.TypeConverter(typeof(System.Windows.Forms.DataGridViewCellStyleConverter))]
public class DataGridViewCellStyle : ICloneable

Vererbung

Object

DataGridViewCellStyle

Attribute

TypeConverterAttribute

Implementiert

ICloneable

Beispiele

Im folgenden Codebeispiel wird die Auswirkung des Festlegens von Eigenschaften auf mehrere DataGridViewCellStyle Objekte veranschaulicht. In diesem Beispiel wird die Hintergrundfarbe von Zellen in festgelegt, DataGridView indem die BackColor -Eigenschaft für die DefaultCellStyle -Eigenschaft festgelegt wird. Die Hintergrundfarbe wird in abwechselnden Zeilen überschrieben, da die BackColor -Eigenschaft für die AlternatingRowsDefaultCellStyle -Eigenschaft festgelegt ist. Das Beispiel bestimmt auch das Format der Datumsangaben in der Spalte namens Last Prepared , indem die -Eigenschaft für Format die -Eigenschaft der Spalte DefaultCellStyle festgelegt wird.

using System;
using System.Drawing;
using System.Collections;
using System.ComponentModel;
using System.Windows.Forms;

public class Form1 : System.Windows.Forms.Form
{
    [STAThreadAttribute()]
    public static void Main()
    {
        Application.Run(new Form1());
    }

    private DataGridView dataGridView1 = new DataGridView();

    protected override void OnLoad(EventArgs e)
    {
        // Create the columns and load the data.
        PopulateDataGridView();

        // Configure the appearance and behavior of the DataGridView.
        InitializeDataGridView();

        // Initialize the form.
        this.Text = "DataGridView style demo";
        this.Size = new Size(600, 250);
        this.Controls.Add(dataGridView1);
        base.OnLoad(e);
    }

    // Configures the appearance and behavior of a DataGridView control.
    private void InitializeDataGridView()
    {
        // Initialize basic DataGridView properties.
        dataGridView1.Dock = DockStyle.Fill;
        dataGridView1.BackgroundColor = Color.LightGray;
        dataGridView1.BorderStyle = BorderStyle.Fixed3D;

        // Set property values appropriate for read-only display and 
        // limited interactivity. 
        dataGridView1.AllowUserToAddRows = false;
        dataGridView1.AllowUserToDeleteRows = false;
        dataGridView1.AllowUserToOrderColumns = true;
        dataGridView1.ReadOnly = true;
        dataGridView1.SelectionMode = DataGridViewSelectionMode.FullRowSelect;
        dataGridView1.MultiSelect = false;
        dataGridView1.AutoSizeRowsMode = DataGridViewAutoSizeRowsMode.None;
        dataGridView1.AllowUserToResizeColumns = false;
        dataGridView1.ColumnHeadersHeightSizeMode = 
            DataGridViewColumnHeadersHeightSizeMode.DisableResizing;
        dataGridView1.AllowUserToResizeRows = false;
        dataGridView1.RowHeadersWidthSizeMode = 
            DataGridViewRowHeadersWidthSizeMode.DisableResizing;

        // Set the selection background color for all the cells.
        dataGridView1.DefaultCellStyle.SelectionBackColor = Color.White;
        dataGridView1.DefaultCellStyle.SelectionForeColor = Color.Black;

        // Set RowHeadersDefaultCellStyle.SelectionBackColor so that its default
        // value won't override DataGridView.DefaultCellStyle.SelectionBackColor.
        dataGridView1.RowHeadersDefaultCellStyle.SelectionBackColor = Color.Empty;

        // Set the background color for all rows and for alternating rows. 
        // The value for alternating rows overrides the value for all rows. 
        dataGridView1.RowsDefaultCellStyle.BackColor = Color.LightGray;
        dataGridView1.AlternatingRowsDefaultCellStyle.BackColor = Color.DarkGray;

        // Set the row and column header styles.
        dataGridView1.ColumnHeadersDefaultCellStyle.ForeColor = Color.White;
        dataGridView1.ColumnHeadersDefaultCellStyle.BackColor = Color.Black;
        dataGridView1.RowHeadersDefaultCellStyle.BackColor = Color.Black;

        // Set the Format property on the "Last Prepared" column to cause
        // the DateTime to be formatted as "Month, Year".
        dataGridView1.Columns["Last Prepared"].DefaultCellStyle.Format = "y";

        // Specify a larger font for the "Ratings" column. 
        using (Font font = new Font(
            dataGridView1.DefaultCellStyle.Font.FontFamily, 25, FontStyle.Bold))
        {
            dataGridView1.Columns["Rating"].DefaultCellStyle.Font = font;
        }

        // Attach a handler to the CellFormatting event.
        dataGridView1.CellFormatting += new
            DataGridViewCellFormattingEventHandler(dataGridView1_CellFormatting);
    }

    // Changes the foreground color of cells in the "Ratings" column 
    // depending on the number of stars. 
    private void dataGridView1_CellFormatting(object sender,
        DataGridViewCellFormattingEventArgs e)
    {
        if (e.ColumnIndex == dataGridView1.Columns["Rating"].Index
            && e.Value != null)
        {
            switch (e.Value.ToString().Length)
            {
                case 1:
                    e.CellStyle.SelectionForeColor = Color.Red;
                    e.CellStyle.ForeColor = Color.Red;
                    break;
                case 2:
                    e.CellStyle.SelectionForeColor = Color.Yellow;
                    e.CellStyle.ForeColor = Color.Yellow;
                    break;
                case 3:
                    e.CellStyle.SelectionForeColor = Color.Green;
                    e.CellStyle.ForeColor = Color.Green;
                    break;
                case 4:
                    e.CellStyle.SelectionForeColor = Color.Blue;
                    e.CellStyle.ForeColor = Color.Blue;
                    break;
            }
        }
    }

    // Creates the columns and loads the data.
    private void PopulateDataGridView()
    {
        // Set the column header names.
        dataGridView1.ColumnCount = 5;
        dataGridView1.Columns[0].Name = "Recipe";
        dataGridView1.Columns[1].Name = "Category";
        dataGridView1.Columns[2].Name = "Main Ingredients";
        dataGridView1.Columns[3].Name = "Last Prepared";
        dataGridView1.Columns[4].Name = "Rating";

        // Populate the rows.
        object[] row1 = new object[]{"Meatloaf", "Main Dish", 
            "ground beef", new DateTime(2000, 3, 23), "*"};
        object[] row2 = new object[]{"Key Lime Pie", "Dessert", 
            "lime juice, evaporated milk", new DateTime(2002, 4, 12), "****"};
        object[] row3 = new object[]{"Orange-Salsa Pork Chops", "Main Dish", 
            "pork chops, salsa, orange juice", new DateTime(2000, 8, 9), "****"};
        object[] row4 = new object[]{"Black Bean and Rice Salad", "Salad", 
            "black beans, brown rice", new DateTime(1999, 5, 7), "****"};
        object[] row5 = new object[]{"Chocolate Cheesecake", "Dessert", 
            "cream cheese", new DateTime(2003, 3, 12), "***"};
        object[] row6 = new object[]{"Black Bean Dip", "Appetizer",
            "black beans, sour cream", new DateTime(2003, 12, 23), "***"};

        // Add the rows to the DataGridView.
        object[] rows = new object[] { row1, row2, row3, row4, row5, row6 };
        foreach (object[] rowArray in rows)
        {
            dataGridView1.Rows.Add(rowArray);
        }

        // Adjust the row heights so that all content is visible.
        dataGridView1.AutoResizeRows(
            DataGridViewAutoSizeRowsMode.AllCellsExceptHeaders);
    }
}

Hinweise

Mit DataGridViewCellStyle der -Klasse können Sie Formatinformationen über mehrere DataGridView Zellen, Zeilen, Spalten und Zeilen- oder Spaltenüberschriften hinweg freigeben, wodurch die Arbeitsspeicheranforderungen beim Festlegen von Stileigenschaften für einzelne Zellen vermieden werden. Weitere Informationen zu Klassen, die über eine Eigenschaft vom Typ DataGridViewCellStyle verfügen, und deren Beziehung zueinander finden Sie unter Zellstile im Windows Forms DataGridView-Steuerelement.

Konstruktoren

DataGridViewCellStyle()	Initialisiert eine neue Instanz der DataGridViewCellStyle-Klasse mit den Standardeigenschaftswerten.
DataGridViewCellStyle(DataGridViewCellStyle)	Initialisiert eine neue Instanz der DataGridViewCellStyle-Klasse unter Verwendung der Eigenschaftswerte des angegebenen DataGridViewCellStyle.

Eigenschaften

Alignment	Ruft einen Wert ab, der die Position des Zelleninhalts in einer DataGridView-Zelle angibt, oder legt diesen Wert fest.
BackColor	Ruft die Hintergrundfarbe für eine DataGridView-Zelle ab oder legt diese fest.
DataSourceNullValue	Ruft den in der Datenquelle gespeicherten Wert ab, wenn der Benutzer einen NULL-Wert in eine Zelle eingibt, oder legt diesen fest.
Font	Ruft die auf den Textinhalt einer DataGridView-Zelle angewendete Schriftart ab oder legt diese fest.
ForeColor	Ruft die Vordergrundfarbe für eine DataGridView-Zelle ab oder legt diese fest.
Format	Ruft die auf den Textinhalt einer DataGridView-Zelle angewendete Formatzeichenfolge ab oder legt diese fest.
FormatProvider	Ruft das Objekt für die Bereitstellung der kulturspezifischen Formatierung der DataGridView-Zellenwerte ab oder legt dieses Objekt fest.
IsDataSourceNullValueDefault	Ruft einen Wert ab, der angibt, ob die DataSourceNullValue-Eigenschaft festgelegt wurde.
IsFormatProviderDefault	Ruft einen Wert ab, der angibt, ob die FormatProvider-Eigenschaft festgelegt wurde.
IsNullValueDefault	Ruft einen Wert ab, der angibt, ob die NullValue-Eigenschaft festgelegt wurde.
NullValue	Ruft den DataGridView-Zellenanzeigewert ab, der dem Zellenwert von Value oder null entspricht, oder legt diesen fest.
Padding	Ruft den Abstand zwischen dem Rand einer DataGridViewCell und ihrem Inhalt ab oder legt diesen fest.
SelectionBackColor	Ruft die beim Auswählen einer DataGridView-Zelle verwendete Hintergrundfarbe ab oder legt diese fest.
SelectionForeColor	Ruft die beim Auswählen einer DataGridView-Zelle verwendete Vordergrundfarbe ab oder legt diese fest.
Tag	Ruft ein Objekt ab, das zusätzliche, auf den DataGridViewCellStyle bezogene Daten enthält, oder legt dieses fest.
WrapMode	Ruft einen Wert ab, der angibt, ob Textinhalt in einer DataGridView-Zelle abgeschnitten oder auf die nachfolgenden Zeilen umbrochen wird, wenn er zu lang für eine Zeile ist, oder legt diesen Wert fest.

Methoden

ApplyStyle(DataGridViewCellStyle)	Übernimmt den angegebenen DataGridViewCellStyle für den aktuellen DataGridViewCellStyle.
Clone()	Erstellt eine genaue Kopie von dieser DataGridViewCellStyle.
Equals(Object)	Gibt einen Wert zurück, der angibt, ob diese Instanz mit dem angegebenen Objekt übereinstimmt.
GetHashCode()	Dient als Hashfunktion für einen bestimmten Typ.
ToString()	Gibt eine Zeichenfolge zurück, die die aktuellen Eigenschafteneinstellungen von DataGridViewCellStyle angibt.

Explizite Schnittstellenimplementierungen

ICloneable.Clone()

Erstellt eine genaue Kopie von dieser DataGridViewCellStyle.

Gilt für:

Weitere Informationen

• DataGridView
• DefaultCellStyle
• RowsDefaultCellStyle
• AlternatingRowsDefaultCellStyle
• ColumnHeadersDefaultCellStyle
• RowHeadersDefaultCellStyle
• CellFormatting
• CellStyleContentChanged
• InheritedStyle
• DefaultCellStyle
• DefaultCellStyle
• DefaultCellStyle
• InheritedStyle
• Style
• DataGridViewCellFormattingEventArgs
• Zellstile im DataGridView-Steuerelement in Windows Forms
• Übersicht über das DataGridView-Steuerelement (Windows Forms)