DataGridViewImageCell Clase

Definición

Espacio de nombres:

System.Windows.Forms

Ensamblado:

System.Windows.Forms.dll

Source:

DataGridViewImageCell.cs

Muestra un gráfico en un DataGridView control .

public ref class DataGridViewImageCell : System::Windows::Forms::DataGridViewCell

public class DataGridViewImageCell : System.Windows.Forms.DataGridViewCell

type DataGridViewImageCell = class
    inherit DataGridViewCell

Public Class DataGridViewImageCell
Inherits DataGridViewCell

Herencia

Object

DataGridViewElement

DataGridViewCell

DataGridViewImageCell

Ejemplos

En el ejemplo de código siguiente se muestra cómo cambiar la imagen en una celda de imagen mediante DataGridViewCell. Este ejemplo de código forma parte de un ejemplo más grande proporcionado para el tema How to: Work with Image Columns en el control DataGridView de formularios Windows Forms.

void dataGridView1_CellClick( Object^ sender, DataGridViewCellEventArgs^ e )
{
   if ( turn->Equals( gameOverString ) )
   {
      return;
   }

   DataGridViewImageCell^ cell = dynamic_cast<DataGridViewImageCell^>(dataGridView1->Rows[ e->RowIndex ]->Cells[ e->ColumnIndex ]);
   if ( cell->Value == blank )
   {
      if ( IsOsTurn() )
      {
         cell->Value = o;
      }
      else
      {
         cell->Value = x;
      }

      ToggleTurn();
   }

   if ( IsAWin( cell ) )
   {
      turn->Text = gameOverString;
   }
}

private void dataGridView1_CellClick(object sender,
    DataGridViewCellEventArgs e)
{

    if (turn.Text.Equals(gameOverString)) { return; }

    DataGridViewImageCell cell = (DataGridViewImageCell)
        dataGridView1.Rows[e.RowIndex].Cells[e.ColumnIndex];

    if (cell.Value == blank)
    {
        if (IsOsTurn())
        {
            cell.Value = o;
        }
        else
        {
            cell.Value = x;
        }
        ToggleTurn();
    }
    if (IsAWin())
    {
        turn.Text = gameOverString;
    }
}

Private Sub dataGridView1_CellClick(ByVal sender As Object, _
    ByVal e As DataGridViewCellEventArgs) _
    Handles dataGridView1.CellClick

    If turn.Text.Equals(gameOverString) Then Return

    Dim cell As DataGridViewImageCell = _
        CType(dataGridView1.Rows(e.RowIndex). _
            Cells(e.ColumnIndex), DataGridViewImageCell)
    If (cell.Value Is blank) Then
        If IsOsTurn() Then
            cell.Value = o
        Else
            cell.Value = x
        End If
        ToggleTurn()
        ToolTip(e)
    End If
    If IsAWin() Then
        turn.Text = gameOverString
    End If
End Sub

Comentarios

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

DataGridViewImageColumn es el tipo de columna especializado para contener celdas de este tipo. De forma predeterminada, DataGridViewImageColumn.CellTemplate se inicializa en un nuevo DataGridViewImageCell. Para realizar el patrón de las celdas dentro de una columna después de una existente DataGridViewImageCell, establezca la propiedad de CellTemplate la columna en la celda que se va a usar como patrón.

Las propiedades relacionadas con celdas de la columna son contenedores para las propiedades con nombre similar de la celda de plantilla. Cambiar los valores de propiedad de la celda de plantilla solo afectará a las celdas en función de la plantilla que se agreguen después del cambio. Sin embargo, cambiar los valores de propiedad relacionados con la celda de la columna actualizará la celda de plantilla y todas las demás celdas de la columna y actualizará la presentación de la columna si es necesario.

Notas a los desarrolladores de herederos

Cuando derive de DataGridViewImageCell y agregue nuevas propiedades a la clase derivada, asegúrese de invalidar el Clone() método para copiar las nuevas propiedades durante las operaciones de clonación. También debe llamar al método de Clone() la clase base para que las propiedades de la clase base se copien en la nueva celda.

Constructores

Nombre	Description
DataGridViewImageCell()	Inicializa una nueva instancia de la DataGridViewImageCell clase , configurándola para su uso con valores de celda distintos de Icon objetos.
DataGridViewImageCell(Boolean)	Inicializa una nueva instancia de la DataGridViewImageCell clase, configurándola opcionalmente para usarla con Icon valores de celda.

Propiedades

Nombre	Description
AccessibilityObject	Obtiene el DataGridViewCell.DataGridViewCellAccessibleObject objeto asignado a .DataGridViewCell (Heredado de DataGridViewCell)
ColumnIndex	Obtiene el índice de columna de esta celda. (Heredado de DataGridViewCell)
ContentBounds	Obtiene el rectángulo delimitador que incluye el área de contenido de la celda. (Heredado de DataGridViewCell)
ContextMenuStrip	Obtiene o establece el menú contextual asociado a la celda. (Heredado de DataGridViewCell)
DataGridView	Obtiene el DataGridView control asociado a este elemento. (Heredado de DataGridViewElement)
DefaultNewRowValue	Obtiene el valor predeterminado que se usa al crear una nueva fila.
Description	Obtiene o establece el texto asociado a la imagen.
Displayed	Obtiene un valor que indica si la celda se muestra actualmente en pantalla. (Heredado de DataGridViewCell)
EditedFormattedValue	Obtiene el valor actual con formato de la celda, independientemente de si la celda está en modo de edición y el valor no se ha confirmado. (Heredado de DataGridViewCell)
EditType	Obtiene el tipo del control de edición hospedado de la celda.
ErrorIconBounds	Obtiene los límites del icono de error de la celda. (Heredado de DataGridViewCell)
ErrorText	Obtiene o establece el texto que describe una condición de error asociada a la celda. (Heredado de DataGridViewCell)
FormattedValue	Obtiene el valor de la celda con formato para mostrar. (Heredado de DataGridViewCell)
FormattedValueType	Obtiene el tipo del valor con formato asociado a la celda.
Frozen	Obtiene un valor que indica si la celda está inmovilizada. (Heredado de DataGridViewCell)
HasStyle	Obtiene un valor que indica si se ha establecido la Style propiedad . (Heredado de DataGridViewCell)
ImageLayout	Obtiene o establece el diseño de gráficos de la celda.
InheritedState	Obtiene el estado actual de la celda como heredado del estado de su fila y columna. (Heredado de DataGridViewCell)
InheritedStyle	Obtiene el estilo aplicado actualmente a la celda. (Heredado de DataGridViewCell)
IsInEditMode	Obtiene un valor que indica si esta celda se está editando actualmente. (Heredado de DataGridViewCell)
OwningColumn	Obtiene la columna que contiene esta celda. (Heredado de DataGridViewCell)
OwningRow	Obtiene la fila que contiene esta celda. (Heredado de DataGridViewCell)
PreferredSize	Obtiene el tamaño, en píxeles, de un área rectangular en la que puede caber la celda. (Heredado de DataGridViewCell)
ReadOnly	Obtiene o establece un valor que indica si se pueden editar los datos de la celda. (Heredado de DataGridViewCell)
Resizable	Obtiene un valor que indica si se puede cambiar el tamaño de la celda. (Heredado de DataGridViewCell)
RowIndex	Obtiene el índice de la fila primaria de la celda. (Heredado de DataGridViewCell)
Selected	Obtiene o establece un valor que indica si se ha seleccionado la celda. (Heredado de DataGridViewCell)
Size	Obtiene el tamaño de la celda. (Heredado de DataGridViewCell)
State	Obtiene el estado de la interfaz de usuario (UI) del elemento. (Heredado de DataGridViewElement)
Style	Obtiene o establece el estilo de la celda. (Heredado de DataGridViewCell)
Tag	Obtiene o establece el objeto que contiene datos complementarios sobre la celda. (Heredado de DataGridViewCell)
ToolTipText	Obtiene o establece el texto de información sobre herramientas asociado a esta celda. (Heredado de DataGridViewCell)
Value	Obtiene o establece el valor asociado a esta celda. (Heredado de DataGridViewCell)
ValueIsIcon	Obtiene o establece un valor que indica si esta celda muestra un Icon valor.
ValueType	Obtiene o establece el tipo de datos de los valores de la celda.
Visible	Obtiene un valor que indica si la celda está en una fila o columna que se ha ocultado. (Heredado de DataGridViewCell)

Métodos

Nombre	Description
AdjustCellBorderStyle(DataGridViewAdvancedBorderStyle, DataGridViewAdvancedBorderStyle, Boolean, Boolean, Boolean, Boolean)	Modifica el estilo de borde de celda de entrada según los criterios especificados. (Heredado de DataGridViewCell)
BorderWidths(DataGridViewAdvancedBorderStyle)	Devuelve un Rectangle que representa los anchos de todos los márgenes de celda. (Heredado de DataGridViewCell)
ClickUnsharesRow(DataGridViewCellEventArgs)	Indica si la fila de la celda no se compartirá cuando se haga clic en ella. (Heredado de DataGridViewCell)
Clone()	Crea una copia exacta de esta celda.
ContentClickUnsharesRow(DataGridViewCellEventArgs)	Indica si la fila de la celda no se compartirá cuando se haga clic en el contenido de la celda. (Heredado de DataGridViewCell)
ContentDoubleClickUnsharesRow(DataGridViewCellEventArgs)	Indica si la fila de la celda no se compartirá cuando se haga doble clic en el contenido de la celda. (Heredado de DataGridViewCell)
CreateAccessibilityInstance()	Crea un nuevo objeto accesible para .DataGridViewImageCell
DetachEditingControl()	Quita el control de edición de la celda de .DataGridView (Heredado de DataGridViewCell)
Dispose()	Libera todos los recursos usados por .DataGridViewCell (Heredado de DataGridViewCell)
Dispose(Boolean)	Libera los recursos no administrados usados por el DataGridViewCell y, opcionalmente, libera los recursos administrados. (Heredado de DataGridViewCell)
DoubleClickUnsharesRow(DataGridViewCellEventArgs)	Indica si la fila de la celda no se compartirá cuando se haga doble clic en la celda. (Heredado de DataGridViewCell)
EnterUnsharesRow(Int32, Boolean)	Indica si la fila primaria no se compartirá cuando el foco se mueva a la celda. (Heredado de DataGridViewCell)
GetClipboardContent(Int32, Boolean, Boolean, Boolean, Boolean, String)	Recupera el valor con formato de la celda que se va a copiar en .Clipboard (Heredado de DataGridViewCell)
GetContentBounds(Graphics, DataGridViewCellStyle, Int32)	Devuelve el rectángulo delimitador que incluye el área de contenido de la celda, que se calcula mediante el estilo de celda y especificados Graphics .
GetContentBounds(Int32)	Devuelve el rectángulo delimitador que incluye el área de contenido de la celda utilizando un estilo de celda predeterminado Graphics y actualmente en vigor para la celda. (Heredado de DataGridViewCell)
GetEditedFormattedValue(Int32, DataGridViewDataErrorContexts)	Devuelve el valor actual con formato de la celda, independientemente de si la celda está en modo de edición y el valor no se ha confirmado. (Heredado de DataGridViewCell)
GetErrorIconBounds(Graphics, DataGridViewCellStyle, Int32)	Devuelve el rectángulo delimitador que incluye el icono de error de la celda, si se muestra uno.
GetErrorText(Int32)	Devuelve una cadena que representa el error de la celda. (Heredado de DataGridViewCell)
GetFormattedValue(Object, Int32, DataGridViewCellStyle, TypeConverter, TypeConverter, DataGridViewDataErrorContexts)	Devuelve un gráfico tal como se mostraría en la celda.
GetInheritedContextMenuStrip(Int32)	Obtiene el menú contextual heredado de la celda actual. (Heredado de DataGridViewCell)
GetInheritedState(Int32)	Devuelve un valor que indica el estado actual de la celda como heredado del estado de su fila y columna. (Heredado de DataGridViewCell)
GetInheritedStyle(DataGridViewCellStyle, Int32, Boolean)	Obtiene el estilo aplicado a la celda. (Heredado de DataGridViewCell)
GetPreferredSize(Graphics, DataGridViewCellStyle, Int32, Size)	Calcula el tamaño preferido, en píxeles, de la celda.
GetSize(Int32)	Obtiene el tamaño de la celda. (Heredado de DataGridViewCell)
GetValue(Int32)	Obtiene el valor de la celda.
InitializeEditingControl(Int32, Object, DataGridViewCellStyle)	Inicializa el control usado para editar la celda. (Heredado de DataGridViewCell)
KeyDownUnsharesRow(KeyEventArgs, Int32)	Indica si la fila primaria no se comparte si el usuario presiona una tecla mientras el foco está en la celda. (Heredado de DataGridViewCell)
KeyEntersEditMode(KeyEventArgs)	Determina si se debe iniciar el modo de edición en función de la clave especificada. (Heredado de DataGridViewCell)
KeyPressUnsharesRow(KeyPressEventArgs, Int32)	Indica si una fila no se compartirá si se presiona una tecla mientras una celda de la fila tiene el foco. (Heredado de DataGridViewCell)
KeyUpUnsharesRow(KeyEventArgs, Int32)	Indica si la fila primaria no se comparte cuando el usuario libera una clave mientras el foco está en la celda. (Heredado de DataGridViewCell)
LeaveUnsharesRow(Int32, Boolean)	Indica si una fila no se compartirá cuando el foco deje una celda en la fila. (Heredado de DataGridViewCell)
MouseClickUnsharesRow(DataGridViewCellMouseEventArgs)	Indica si una fila no se compartirá si el usuario hace clic en un botón del mouse mientras el puntero está en una celda de la fila. (Heredado de DataGridViewCell)
MouseDoubleClickUnsharesRow(DataGridViewCellMouseEventArgs)	Indica si una fila no se compartirá si el usuario hace doble clic en una celda de la fila. (Heredado de DataGridViewCell)
MouseDownUnsharesRow(DataGridViewCellMouseEventArgs)	Indica si una fila no se compartirá cuando el usuario mantenga presionado un botón del mouse mientras el puntero está en una celda de la fila. (Heredado de DataGridViewCell)
MouseEnterUnsharesRow(Int32)	Indica si una fila no se compartirá cuando el puntero del mouse se mueva sobre una celda de la fila. (Heredado de DataGridViewCell)
MouseLeaveUnsharesRow(Int32)	Indica si una fila no se compartirá cuando el puntero del mouse salga de la fila. (Heredado de DataGridViewCell)
MouseMoveUnsharesRow(DataGridViewCellMouseEventArgs)	Indica si una fila no se compartirá cuando el puntero del mouse se mueva sobre una celda de la fila. (Heredado de DataGridViewCell)
MouseUpUnsharesRow(DataGridViewCellMouseEventArgs)	Indica si una fila no se compartirá cuando el usuario libere un botón del mouse mientras el puntero está en una celda de la fila. (Heredado de DataGridViewCell)
OnClick(DataGridViewCellEventArgs)	Se llama cuando se hace clic en la celda. (Heredado de DataGridViewCell)
OnContentClick(DataGridViewCellEventArgs)	Se llama cuando se hace clic en el contenido de la celda. (Heredado de DataGridViewCell)
OnContentDoubleClick(DataGridViewCellEventArgs)	Se llama cuando se hace doble clic en el contenido de la celda. (Heredado de DataGridViewCell)
OnDataGridViewChanged()	Se llama cuando cambia la DataGridView propiedad de la celda. (Heredado de DataGridViewCell)
OnDoubleClick(DataGridViewCellEventArgs)	Se llama cuando se hace doble clic en la celda. (Heredado de DataGridViewCell)
OnEnter(Int32, Boolean)	Se llama cuando el foco se mueve a una celda. (Heredado de DataGridViewCell)
OnKeyDown(KeyEventArgs, Int32)	Se llama cuando se presiona una tecla de carácter mientras el foco está en una celda. (Heredado de DataGridViewCell)
OnKeyPress(KeyPressEventArgs, Int32)	Se llama cuando se presiona una tecla mientras el foco está en una celda. (Heredado de DataGridViewCell)
OnKeyUp(KeyEventArgs, Int32)	Se llama cuando se libera una tecla de carácter mientras el foco está en una celda. (Heredado de DataGridViewCell)
OnLeave(Int32, Boolean)	Se llama cuando el foco se mueve de una celda. (Heredado de DataGridViewCell)
OnMouseClick(DataGridViewCellMouseEventArgs)	Se llama cuando el usuario hace clic en un botón del mouse mientras el puntero está en una celda. (Heredado de DataGridViewCell)
OnMouseDoubleClick(DataGridViewCellMouseEventArgs)	Se llama cuando el usuario hace doble clic en un botón del mouse mientras el puntero está en una celda. (Heredado de DataGridViewCell)
OnMouseDown(DataGridViewCellMouseEventArgs)	Se llama cuando el usuario mantiene presionado un botón del mouse mientras el puntero está en una celda. (Heredado de DataGridViewCell)
OnMouseEnter(Int32)	Se llama cuando el puntero del mouse se mueve sobre una celda. (Heredado de DataGridViewCell)
OnMouseLeave(Int32)	Se llama cuando el puntero del mouse sale de la celda. (Heredado de DataGridViewCell)
OnMouseMove(DataGridViewCellMouseEventArgs)	Se llama cuando el puntero del mouse se mueve dentro de una celda. (Heredado de DataGridViewCell)
OnMouseUp(DataGridViewCellMouseEventArgs)	Se llama cuando el usuario suelta un botón del mouse mientras el puntero está en una celda. (Heredado de DataGridViewCell)
Paint(Graphics, Rectangle, Rectangle, Int32, DataGridViewElementStates, Object, Object, String, DataGridViewCellStyle, DataGridViewAdvancedBorderStyle, DataGridViewPaintParts)	Pinta el objeto actual DataGridViewImageCell.
PaintBorder(Graphics, Rectangle, Rectangle, DataGridViewCellStyle, DataGridViewAdvancedBorderStyle)	Pinta el borde del objeto actual DataGridViewCell. (Heredado de DataGridViewCell)
PaintErrorIcon(Graphics, Rectangle, Rectangle, String)	Pinta el icono de error del objeto actual DataGridViewCell. (Heredado de DataGridViewCell)
ParseFormattedValue(Object, DataGridViewCellStyle, TypeConverter, TypeConverter)	Convierte un valor con formato para mostrar en un valor de celda real. (Heredado de DataGridViewCell)
PositionEditingControl(Boolean, Boolean, Rectangle, Rectangle, DataGridViewCellStyle, Boolean, Boolean, Boolean, Boolean)	Establece la ubicación y el tamaño del control de edición hospedado por una celda del DataGridView control. (Heredado de DataGridViewCell)
PositionEditingPanel(Rectangle, Rectangle, DataGridViewCellStyle, Boolean, Boolean, Boolean, Boolean)	Establece la ubicación y el tamaño del panel de edición hospedado por la celda y devuelve los límites normales del control de edición dentro del panel de edición. (Heredado de DataGridViewCell)
RaiseCellClick(DataGridViewCellEventArgs)	Genera el evento CellClick. (Heredado de DataGridViewElement)
RaiseCellContentClick(DataGridViewCellEventArgs)	Genera el evento CellContentClick. (Heredado de DataGridViewElement)
RaiseCellContentDoubleClick(DataGridViewCellEventArgs)	Genera el evento CellContentDoubleClick. (Heredado de DataGridViewElement)
RaiseCellValueChanged(DataGridViewCellEventArgs)	Genera el evento CellValueChanged. (Heredado de DataGridViewElement)
RaiseDataError(DataGridViewDataErrorEventArgs)	Genera el evento DataError. (Heredado de DataGridViewElement)
RaiseMouseWheel(MouseEventArgs)	Genera el evento MouseWheel. (Heredado de DataGridViewElement)
SetValue(Int32, Object)	Establece el valor de la celda. (Heredado de DataGridViewCell)
ToString()	Devuelve una cadena que describe el objeto actual.

Consulte también

• DataGridView
• DataGridViewCell
• DataGridViewImageColumn
• CellTemplate
• Image
• Icon
• ValueIsIcon