Esta documentación está archivada y no tiene mantenimiento.

DataGridViewButtonCell (Clase)

Muestra una interfaz de usuario con apariencia de botón para su uso en un control DataGridView.

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

public class DataGridViewButtonCell : DataGridViewCell
public class DataGridViewButtonCell extends DataGridViewCell
public class DataGridViewButtonCell extends DataGridViewCell
No aplicable.

La clase DataGridViewButtonCell es un tipo especializado de DataGridViewCell que se utiliza para mostrar una interfaz de usuario con apariencia de botón.

El control DataGridViewButtonColumn es el tipo de columna especializó en contener celdas de este tipo. Para modelar las celdas dentro de una columna como un control DataGridViewButtonCell existente, establezca la propiedad CellTemplate de la columna en esa celda. De manera predeterminada, la propiedad CellTemplate se inicializa con una nueva DataGridViewButtonCell.

Las propiedades de la columna relacionadas con celdas actúan como contenedores para las propiedades con nombres similares de la celda de plantilla. Al cambiar los valores de propiedad de la celda de plantilla sólo se verán afectadas las celdas que estén basadas en la plantilla y se hayan agregado después del cambio. Al cambiar los valores de propiedad relacionados con las celdas de la columna, sin embargo, se actualizará la celda de la plantilla y también todas las demás celdas de la columna, actualizando su presentación si es necesario.

NotaNota:

Cuando los estilos visuales están habilitados, los botones de una columna de botones se pintan usando ButtonRenderer y los estilos de celda especificados mediante propiedades como DefaultCellStyle no tienen ningún efecto.

Notas para los herederos: Cuando derive del control DataGridViewButtonCell y agregue nuevas propiedades a la clase derivada, asegúrese de reemplazar el método Clone para copiar las nuevas propiedades durante las operaciones de clonación. También debe llamar al método Clone de la clase base para que las propiedades de la clase base se copien en la nueva celda.

En el ejemplo de código siguiente se muestra cómo utilizar DataGridViewCell como una plantilla para DataGridViewColumn. Los cambios de estilo realizados en cualquier celda de la columna afectan a todas las celdas de la columna. Este ejemplo de código forma parte de un ejemplo más extenso proporcionado para la clase DataGridViewColumn.

private void CustomizeCellsInThirdColumn()
{
    int thirdColumn = 2;
    DataGridViewColumn column =
        dataGridView.Columns[thirdColumn];
    DataGridViewCell cell = new DataGridViewTextBoxCell();

    cell.Style.BackColor = Color.Wheat;
    column.CellTemplate = cell;
}

Los miembros estáticos públicos (Shared en Visual Basic) de este tipo son seguros para la ejecución de subprocesos. No se garantiza que los miembros de instancias sean seguros para la ejecución de subprocesos.

Windows 98, Windows 2000 Service Pack 4, Windows CE, Windows Millennium, Windows Mobile para Pocket PC, Windows Mobile para Smartphone, Windows Server 2003, Windows XP Media Center, Windows XP Professional x64, Windows XP SP2, Windows XP Starter

Microsoft .NET Framework 3.0 es compatible con Windows Vista, Microsoft Windows XP SP2 y Windows Server 2003 SP1.

.NET Framework

Compatible con: 3.0, 2.0
Mostrar: