DataGridViewCellStyle Sınıf

Tanım

Ad Alanı:

System.Windows.Forms

Bütünleştirilmiş Kod:

System.Windows.Forms.dll

Kaynak:

DataGridViewCellStyle.cs

Denetim içindeki DataGridView tek tek hücrelere uygulanan biçimlendirme ve stil bilgilerini temsil eder.

C#

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

Devralma

Object

DataGridViewCellStyle

Öznitelikler

TypeConverterAttribute

Uygulamalar

ICloneable

Örnekler

Aşağıdaki kod örneği, özelliklerin birden çok DataGridViewCellStyle nesne üzerindeki etkisini gösterir. Bu örnek, özelliğinde özelliğini DefaultCellStyle ayarlayarak BackColor içindeki DataGridView hücrelerin arka plan rengini ayarlar. Özellik özelliğinde ayarlandığından arka plan rengi değişen satırlarda BackColorAlternatingRowsDefaultCellStyle geçersiz kılınıyor. Örnek, sütunun özelliğinde özelliğini ayarlayarak Format adlı Last Prepared sütundaki tarihlerin DefaultCellStyle biçimini de belirler.

C#

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);
    }
}

Açıklamalar

DataGridViewCellStyle sınıfı, stil bilgilerini birden çok DataGridView hücre, satır, sütun ve satır veya sütun başlığı arasında paylaşmanıza olanak tanır ve tek tek hücrelerde stil özelliklerini ayarlamanın bellek gereksinimlerini önler. Türünde DataGridViewCellStyle bir özelliğe sahip sınıflar ve birbirleriyle ilişkileri hakkında daha fazla bilgi için bkz. Windows Forms DataGridView Denetimindeki Hücre Stilleri.

Oluşturucular

DataGridViewCellStyle()	Varsayılan özellik değerlerini kullanarak sınıfın DataGridViewCellStyle yeni bir örneğini başlatır.
DataGridViewCellStyle(DataGridViewCellStyle)	Belirtilen DataGridViewCellStyleözelliğinin DataGridViewCellStyle özellik değerlerini kullanarak sınıfının yeni bir örneğini başlatır.

Özellikler

Alignment	Hücre içeriğinin bir hücre içindeki konumunu belirten bir DataGridView değeri alır veya ayarlar.
BackColor	Hücrenin DataGridView arka plan rengini alır veya ayarlar.
DataSourceNullValue	Kullanıcı bir hücreye null değer girdiğinde veri kaynağına kaydedilen değeri alır veya ayarlar.
Font	Hücrenin metin içeriğine DataGridView uygulanan yazı tipini alır veya ayarlar.
ForeColor	Hücrenin ön plan rengini DataGridView alır veya ayarlar.
Format	Hücrenin metin içeriğine DataGridView uygulanan biçim dizesini alır veya ayarlar.
FormatProvider	Hücre değerlerinin kültüre özgü biçimlendirmesini DataGridView sağlamak için kullanılan nesneyi alır veya ayarlar.
IsDataSourceNullValueDefault	Özelliğin ayarlanıp ayarlanmadığını DataSourceNullValue belirten bir değer alır.
IsFormatProviderDefault	Özelliğin ayarlanıp ayarlanmadığını FormatProvider belirten bir değer alır.
IsNullValueDefault	Özelliğin ayarlanıp ayarlanmadığını NullValue belirten bir değer alır.
NullValue	veya hücre değerine karşılık gelen hücre görüntüleme değerini Value alır veya nullayarlarDataGridView.
Padding	Bir DataGridViewCell ile içeriğinin kenarı arasındaki boşluğu alır veya ayarlar.
SelectionBackColor	Seçildiğinde hücre DataGridView tarafından kullanılan arka plan rengini alır veya ayarlar.
SelectionForeColor	Seçili bir DataGridView hücre tarafından kullanılan ön plan rengini alır veya ayarlar.
Tag	ile ilgili DataGridViewCellStyleek veriler içeren bir nesneyi alır veya ayarlar.
WrapMode	Bir hücredeki metin içeriğinin sonraki satırlara kaydırıldığını veya tek bir DataGridView satıra sığamayacak kadar uzun olduğunda kesildiğini belirten bir değer alır veya ayarlar.

Yöntemler

ApplyStyle(DataGridViewCellStyle)	Belirtilen DataGridViewCellStyle öğesini geçerli DataGridViewCellStyleöğesine uygular.
Clone()	Bu DataGridViewCellStyleöğesinin tam bir kopyasını oluşturur.
Equals(Object)	Bu örneğin belirtilen nesneye eşdeğer olup olmadığını belirten bir değer döndürür.
GetHashCode()	Belirli bir tür için karma işlevi olarak görev yapar.
ToString()	öğesinin geçerli özellik ayarlarını DataGridViewCellStylegösteren bir dize döndürür.

Belirtik Arabirim Kullanımları

ICloneable.Clone()

Bu DataGridViewCellStyleöğesinin tam bir kopyasını oluşturur.

Şunlara uygulanır

Ayrıca bkz.

• DataGridView
• DefaultCellStyle
• RowsDefaultCellStyle
• AlternatingRowsDefaultCellStyle
• ColumnHeadersDefaultCellStyle
• RowHeadersDefaultCellStyle
• CellFormatting
• CellStyleContentChanged
• InheritedStyle
• DefaultCellStyle
• DefaultCellStyle
• DefaultCellStyle
• InheritedStyle
• Style
• DataGridViewCellFormattingEventArgs
• Windows Forms DataGridView Denetimindeki Hücre Stilleri
• DataGridView Denetimine Genel Bakış (Windows Forms)