Este artículo se tradujo automáticamente. Para ver el artículo en inglés, active la casilla Inglés. Además, puede mostrar el texto en inglés en una ventana emergente si mueve el puntero del mouse sobre el texto.
Traducción
Inglés

Clase DataGridViewCellStyle

 

Publicado: octubre de 2016

Representa la información de formato y estilo aplicada a las celdas individuales dentro de un DataGridView control.

Espacio de nombres:   System.Windows.Forms
Ensamblado:  System.Windows.Forms (en System.Windows.Forms.dll)

System.Object
  System.Windows.Forms.DataGridViewCellStyle

[TypeConverterAttribute(typeof(DataGridViewCellStyleConverter))]
public class DataGridViewCellStyle : ICloneable

NombreDescripción
System_CAPS_pubmethodDataGridViewCellStyle()

Inicializa una nueva instancia de la DataGridViewCellStyle clase con los valores de propiedad predeterminados.

System_CAPS_pubmethodDataGridViewCellStyle(DataGridViewCellStyle)

Inicializa una nueva instancia de la DataGridViewCellStyle los valores de propiedad del objeto de clase DataGridViewCellStyle.

NombreDescripción
System_CAPS_pubpropertyAlignment

Obtiene o establece un valor que indica la posición de la celda contenido dentro de un DataGridView celda.

System_CAPS_pubpropertyBackColor

Obtiene o establece el color de fondo de un DataGridView celda.

System_CAPS_pubpropertyDataSourceNullValue

Obtiene o establece el valor guardado en el origen de datos cuando el usuario escribe un valor nulo en una celda.

System_CAPS_pubpropertyFont

Obtiene o establece la fuente aplicada al contenido textual de un DataGridView celda.

System_CAPS_pubpropertyForeColor

Obtiene o establece el color de primer plano de un DataGridView celda.

System_CAPS_pubpropertyFormat

Obtiene o establece la cadena de formato aplicada al contenido textual de un DataGridView celda.

System_CAPS_pubpropertyFormatProvider

Obtiene o establece el objeto utilizado para proporcionar el formato específico de la referencia cultural de DataGridView los valores de celda.

System_CAPS_pubpropertyIsDataSourceNullValueDefault

Obtiene un valor que indica si el DataSourceNullValue se ha establecido la propiedad.

System_CAPS_pubpropertyIsFormatProviderDefault

Obtiene un valor que indica si el FormatProvider se ha establecido la propiedad.

System_CAPS_pubpropertyIsNullValueDefault

Obtiene un valor que indica si el NullValue se ha establecido la propiedad.

System_CAPS_pubpropertyNullValue

Obtiene o establece la DataGridView valor de mostrar la celda correspondiente a un valor de celda DBNull.Value o null.

System_CAPS_pubpropertyPadding

Obtiene o establece el espacio entre el borde de un DataGridViewCell y su contenido.

System_CAPS_pubpropertySelectionBackColor

Obtiene o establece el color de fondo utilizado por un DataGridView cuando se selecciona la celda.

System_CAPS_pubpropertySelectionForeColor

Obtiene o establece el color de primer plano utilizado por un DataGridView cuando se selecciona la celda.

System_CAPS_pubpropertyTag

Obtiene o establece un objeto que contiene datos adicionales relacionados con el DataGridViewCellStyle.

System_CAPS_pubpropertyWrapMode

Obtiene o establece un valor que indica si el texto contenido en un DataGridView celda se ajusta a las líneas siguientes o se trunca cuando es demasiado largo para caber en una sola línea.

NombreDescripción
System_CAPS_pubmethodApplyStyle(DataGridViewCellStyle)

Se aplica especificado DataGridViewCellStyle actual DataGridViewCellStyle.

System_CAPS_pubmethodClone()

Crea una copia exacta de este objeto DataGridViewCellStyle.

System_CAPS_pubmethodEquals(Object)

Devuelve un valor que indica si esta instancia es equivalente al objeto especificado.(Invalida Object.Equals(Object)).

System_CAPS_protmethodFinalize()

Permite que un objeto intente liberar recursos y realizar otras operaciones de limpieza antes de ser reclamado por el recolector de basura. (Heredado de Object).

System_CAPS_pubmethodGetHashCode()

Actúa como función hash para un tipo concreto.(Invalida Object.GetHashCode()).

System_CAPS_pubmethodGetType()

Obtiene el Type de la instancia actual.(Heredado de Object).

System_CAPS_protmethodMemberwiseClone()

Crea una copia superficial del Object actual.(Heredado de Object).

System_CAPS_pubmethodToString()

Devuelve una cadena que indica la configuración actual de la propiedad de la DataGridViewCellStyle.(Invalida Object.ToString()).

NombreDescripción
System_CAPS_pubinterfaceSystem_CAPS_privmethodICloneable.Clone()

Crea una copia exacta de este objeto DataGridViewCellStyle.

La DataGridViewCellStyle clase le permite compartir información de estilo entre varios DataGridView celdas, filas, columnas y encabezados de fila o columna, evitando los requisitos de memoria de establecer las propiedades de estilo de celdas individuales. Para obtener más información acerca de las clases que tienen una propiedad de tipo DataGridViewCellStyle y cómo se relacionan entre sí, vea Estilos de celda en el control DataGridView de formularios Windows Forms.

En el ejemplo de código siguiente se muestra el efecto de establecer las propiedades en varios DataGridViewCellStyle objetos. Este ejemplo establece el color de fondo de las celdas de la DataGridView estableciendo el BackColor propiedad en el DefaultCellStyle propiedad. El color de fondo se reemplaza en filas alternas porque la BackColor propiedad se establece en el AlternatingRowsDefaultCellStyle propiedad. El ejemplo también determina el formato de fechas en la columna denominada Last Prepared estableciendo el Format propiedad en la columna DefaultCellStyle propiedad.

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

}

.NET Framework
Disponible desde 2.0

Cualquier miembro ( Compartido en Visual Basic) estático público de este tipo es seguro para subprocesos. No se garantiza que los miembros de instancia sean seguros para subprocesos.

Volver al principio
Mostrar: