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

DataGridViewImageCell (Clase)

Muestra el gráfico de un control DataGridView.

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

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

La clase DataGridViewImageCell es un tipo especializado de DataGridViewCell utilizado para mostrar un control Image o Icon, dependiendo del valor de la propiedad ValueIsIcon. Normalmente, la propiedad ReadOnly de DataGridViewImageCell se establece en true para indicar que el usuario no puede editar el contenido de la celda.

DataGridViewImageColumn corresponde al tipo de columna especializado con el fin de contener celdas de este tipo. Para modelar las celdas de una columna como control DataGridViewImageCell existente, establezca la propiedad CellTemplate de la columna en esa celda. De forma predeterminada, la propiedad CellTemplate se inicializa con una nueva instancia de DataGridViewImageCell.

Las propiedades de la columna relacionadas con celdas actúan como contenedores de las propiedades con una denominación similar 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, así como el resto de las celdas de la columna, actualizando su presentación en caso necesario.

Notas para los herederos: Cuando derive del control DataGridViewImageCell 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 esta clase 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 referente a 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: