DataGridViewCell Clase

Definición

Espacio de nombres:

System.Windows.Forms

Ensamblado:

System.Windows.Forms.dll

Representa una celda individual de un DataGridView control .

public ref class DataGridViewCell abstract : System::Windows::Forms::DataGridViewElement, ICloneable, IDisposable

[System.ComponentModel.TypeConverter(typeof(System.Windows.Forms.DataGridViewCellConverter))]
public abstract class DataGridViewCell : System.Windows.Forms.DataGridViewElement, ICloneable, IDisposable

[<System.ComponentModel.TypeConverter(typeof(System.Windows.Forms.DataGridViewCellConverter))>]
type DataGridViewCell = class
    inherit DataGridViewElement
    interface ICloneable
    interface IDisposable

Public MustInherit Class DataGridViewCell
Inherits DataGridViewElement
Implements ICloneable, IDisposable

Herencia

Object

DataGridViewElement

DataGridViewCell

Derivado

System.Windows.Forms.DataGridViewButtonCell

System.Windows.Forms.DataGridViewCheckBoxCell

System.Windows.Forms.DataGridViewComboBoxCell

System.Windows.Forms.DataGridViewHeaderCell

System.Windows.Forms.DataGridViewImageCell

System.Windows.Forms.DataGridViewLinkCell

System.Windows.Forms.DataGridViewTextBoxCell

Atributos

TypeConverterAttribute

Implementaciones

ICloneable IDisposable

Ejemplos

En el ejemplo de código siguiente se muestra el uso de este tipo. Para obtener más información sobre este ejemplo, vea How to: Add ToolTips to Individual Cells in a Windows Forms DataGridView Control.

// Sets the ToolTip text for cells in the Rating column.
void dataGridView1_CellFormatting(Object^ /*sender*/, 
    DataGridViewCellFormattingEventArgs^ e)
{
    if ( (e->ColumnIndex == this->dataGridView1->Columns["Rating"]->Index)
        && e->Value != nullptr )
    {
        DataGridViewCell^ cell = 
            this->dataGridView1->Rows[e->RowIndex]->Cells[e->ColumnIndex];
        if (e->Value->Equals("*"))
        {                
            cell->ToolTipText = "very bad";
        }
        else if (e->Value->Equals("**"))
        {
            cell->ToolTipText = "bad";
        }
        else if (e->Value->Equals("***"))
        {
            cell->ToolTipText = "good";
        }
        else if (e->Value->Equals("****"))
        {
            cell->ToolTipText = "very good";
        }
    }
}

// Sets the ToolTip text for cells in the Rating column.
void dataGridView1_CellFormatting(object sender, 
    DataGridViewCellFormattingEventArgs e)
{
    if ( (e.ColumnIndex == this.dataGridView1.Columns["Rating"].Index)
        && e.Value != null )
    {
        DataGridViewCell cell = 
            this.dataGridView1.Rows[e.RowIndex].Cells[e.ColumnIndex];
        if (e.Value.Equals("*"))
        {                
            cell.ToolTipText = "very bad";
        }
        else if (e.Value.Equals("**"))
        {
            cell.ToolTipText = "bad";
        }
        else if (e.Value.Equals("***"))
        {
            cell.ToolTipText = "good";
        }
        else if (e.Value.Equals("****"))
        {
            cell.ToolTipText = "very good";
        }
    }
}

' Sets the ToolTip text for cells in the Rating column.
Sub dataGridView1_CellFormatting(ByVal sender As Object, _
    ByVal e As DataGridViewCellFormattingEventArgs) _
    Handles dataGridView1.CellFormatting

    If e.ColumnIndex = Me.dataGridView1.Columns("Rating").Index _
        AndAlso (e.Value IsNot Nothing) Then

        With Me.dataGridView1.Rows(e.RowIndex).Cells(e.ColumnIndex)

            If e.Value.Equals("*") Then
                .ToolTipText = "very bad"
            ElseIf e.Value.Equals("**") Then
                .ToolTipText = "bad"
            ElseIf e.Value.Equals("***") Then
                .ToolTipText = "good"
            ElseIf e.Value.Equals("****") Then
                .ToolTipText = "very good"
            End If

        End With

    End If

End Sub

Comentarios

La DataGridViewCell clase representa una celda individual de un DataGridView control . Puede recuperar celdas a través de la Cells colección de .DataGridViewRow

Fila y columna para identificar DataGridViewCell la ubicación de la celda en .DataGridView Una celda típica contiene datos específicos de la fila y columna en la que está contenido. La celda se puede personalizar de varias maneras estableciendo sus propiedades y controlando los eventos asociados.

Notas a los implementadores

Cuando derive de DataGridViewCell 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
DataGridViewCell()	Inicializa una nueva instancia de la clase DataGridViewCell.

Propiedades

Nombre	Description
AccessibilityObject	Obtiene el DataGridViewCell.DataGridViewCellAccessibleObject objeto asignado a .DataGridViewCell
ColumnIndex	Obtiene el índice de columna de esta celda.
ContentBounds	Obtiene el rectángulo delimitador que incluye el área de contenido de la celda.
ContextMenuStrip	Obtiene o establece el menú contextual asociado a la celda.
DataGridView	Obtiene el DataGridView control asociado a este elemento. (Heredado de DataGridViewElement)
DefaultNewRowValue	Obtiene el valor predeterminado de una celda de la fila para los registros nuevos.
Displayed	Obtiene un valor que indica si la celda se muestra actualmente en pantalla.
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.
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.
ErrorText	Obtiene o establece el texto que describe una condición de error asociada a la celda.
FormattedValue	Obtiene el valor de la celda con formato para mostrar.
FormattedValueType	Obtiene el tipo del valor con formato asociado a la celda.
Frozen	Obtiene un valor que indica si la celda está inmovilizada.
HasStyle	Obtiene un valor que indica si se ha establecido la Style propiedad .
InheritedState	Obtiene el estado actual de la celda como heredado del estado de su fila y columna.
InheritedStyle	Obtiene el estilo aplicado actualmente a la celda.
IsInEditMode	Obtiene un valor que indica si esta celda se está editando actualmente.
OwningColumn	Obtiene la columna que contiene esta celda.
OwningRow	Obtiene la fila que contiene esta celda.
PreferredSize	Obtiene el tamaño, en píxeles, de un área rectangular en la que puede caber la celda.
ReadOnly	Obtiene o establece un valor que indica si se pueden editar los datos de la celda.
Resizable	Obtiene un valor que indica si se puede cambiar el tamaño de la celda.
RowIndex	Obtiene el índice de la fila primaria de la celda.
Selected	Obtiene o establece un valor que indica si se ha seleccionado la celda.
Size	Obtiene el tamaño de la celda.
State	Obtiene el estado de la interfaz de usuario (UI) del elemento. (Heredado de DataGridViewElement)
Style	Obtiene o establece el estilo de la celda.
Tag	Obtiene o establece el objeto que contiene datos complementarios sobre la celda.
ToolTipText	Obtiene o establece el texto de información sobre herramientas asociado a esta celda.
Value	Obtiene o establece el valor asociado a esta celda.
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.

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.
BorderWidths(DataGridViewAdvancedBorderStyle)	Devuelve un Rectangle que representa los anchos de todos los márgenes de celda.
ClickUnsharesRow(DataGridViewCellEventArgs)	Indica si la fila de la celda no se compartirá cuando se haga clic en ella.
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.
ContentDoubleClickUnsharesRow(DataGridViewCellEventArgs)	Indica si la fila de la celda no se compartirá cuando se haga doble clic en el contenido de la celda.
CreateAccessibilityInstance()	Crea un nuevo objeto accesible para .DataGridViewCell
DetachEditingControl()	Quita el control de edición de la celda de .DataGridView
Dispose()	Libera todos los recursos usados por .DataGridViewCell
Dispose(Boolean)	Libera los recursos no administrados utilizados por DataGridViewCell y, opcionalmente, libera los recursos administrados.
DoubleClickUnsharesRow(DataGridViewCellEventArgs)	Indica si la fila de la celda no se compartirá cuando se haga doble clic en la celda.
EnterUnsharesRow(Int32, Boolean)	Indica si la fila primaria no se compartirá cuando el foco se mueva a la celda.
Equals(Object)	Determina si el objeto especificado es igual al objeto actual. (Heredado de Object)
Finalize()	Libera los recursos no administrados y realiza otras operaciones de limpieza antes de que la DataGridViewCell recolección de elementos no utilizados la recupere.
GetClipboardContent(Int32, Boolean, Boolean, Boolean, Boolean, String)	Recupera el valor con formato de la celda que se va a copiar en .Clipboard
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.
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.
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.
GetFormattedValue(Object, Int32, DataGridViewCellStyle, TypeConverter, TypeConverter, DataGridViewDataErrorContexts)	Obtiene el valor de la celda con formato para mostrar.
GetHashCode()	Actúa como la función hash predeterminada. (Heredado de Object)
GetInheritedContextMenuStrip(Int32)	Obtiene el menú contextual heredado de la celda actual.
GetInheritedState(Int32)	Devuelve un valor que indica el estado actual de la celda como heredado del estado de su fila y columna.
GetInheritedStyle(DataGridViewCellStyle, Int32, Boolean)	Obtiene el estilo aplicado a la celda.
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.
GetType()	Obtiene el Type de la instancia actual. (Heredado de Object)
GetValue(Int32)	Obtiene el valor de la celda.
InitializeEditingControl(Int32, Object, DataGridViewCellStyle)	Inicializa el control usado para editar la celda.
KeyDownUnsharesRow(KeyEventArgs, Int32)	Indica si la fila primaria no se comparte si el usuario presiona una tecla mientras el foco está en la celda.
KeyEntersEditMode(KeyEventArgs)	Determina si se debe iniciar el modo de edición en función de la clave especificada.
KeyPressUnsharesRow(KeyPressEventArgs, Int32)	Indica si una fila no se compartirá si se presiona una tecla mientras una celda de la fila tiene el foco.
KeyUpUnsharesRow(KeyEventArgs, Int32)	Indica si la fila primaria no se comparte cuando el usuario libera una clave mientras el foco está en la celda.
LeaveUnsharesRow(Int32, Boolean)	Indica si una fila no se compartirá cuando el foco deje una celda en la fila.
MeasureTextHeight(Graphics, String, Font, Int32, TextFormatFlags, Boolean)	Obtiene el alto, en píxeles, del texto especificado, dadas las características especificadas. También indica si el ancho necesario es mayor que el ancho máximo especificado.
MeasureTextHeight(Graphics, String, Font, Int32, TextFormatFlags)	Obtiene el alto, en píxeles, del texto especificado, dadas las características especificadas.
MeasureTextPreferredSize(Graphics, String, Font, Single, TextFormatFlags)	Obtiene el alto y el ancho ideales del texto especificado según las características especificadas.
MeasureTextSize(Graphics, String, Font, TextFormatFlags)	Obtiene el alto y el ancho del texto especificado según las características especificadas.
MeasureTextWidth(Graphics, String, Font, Int32, TextFormatFlags)	Obtiene el ancho, en píxeles, del texto especificado según las características especificadas.
MemberwiseClone()	Crea una copia superficial del Objectactual. (Heredado de Object)
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.
MouseDoubleClickUnsharesRow(DataGridViewCellMouseEventArgs)	Indica si una fila no se compartirá si el usuario hace doble clic en una celda de la fila.
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.
MouseEnterUnsharesRow(Int32)	Indica si una fila no se compartirá cuando el puntero del mouse se mueva sobre una celda de la fila.
MouseLeaveUnsharesRow(Int32)	Indica si una fila no se compartirá cuando el puntero del mouse salga de la fila.
MouseMoveUnsharesRow(DataGridViewCellMouseEventArgs)	Indica si una fila no se compartirá cuando el puntero del mouse se mueva sobre una celda de la fila.
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.
OnClick(DataGridViewCellEventArgs)	Se llama cuando se hace clic en la celda.
OnContentClick(DataGridViewCellEventArgs)	Se llama cuando se hace clic en el contenido de la celda.
OnContentDoubleClick(DataGridViewCellEventArgs)	Se llama cuando se hace doble clic en el contenido de la celda.
OnDataGridViewChanged()	Se llama cuando cambia la DataGridView propiedad de la celda.
OnDoubleClick(DataGridViewCellEventArgs)	Se llama cuando se hace doble clic en la celda.
OnEnter(Int32, Boolean)	Se llama cuando el foco se mueve a una celda.
OnKeyDown(KeyEventArgs, Int32)	Se llama cuando se presiona una tecla de carácter mientras el foco está en una celda.
OnKeyPress(KeyPressEventArgs, Int32)	Se llama cuando se presiona una tecla mientras el foco está en una celda.
OnKeyUp(KeyEventArgs, Int32)	Se llama cuando se libera una tecla de carácter mientras el foco está en una celda.
OnLeave(Int32, Boolean)	Se llama cuando el foco se mueve de una celda.
OnMouseClick(DataGridViewCellMouseEventArgs)	Se llama cuando el usuario hace clic en un botón del mouse mientras el puntero está en una celda.
OnMouseDoubleClick(DataGridViewCellMouseEventArgs)	Se llama cuando el usuario hace doble clic en un botón del mouse mientras el puntero está en una celda.
OnMouseDown(DataGridViewCellMouseEventArgs)	Se llama cuando el usuario mantiene presionado un botón del mouse mientras el puntero está en una celda.
OnMouseEnter(Int32)	Se llama cuando el puntero del mouse se mueve sobre una celda.
OnMouseLeave(Int32)	Se llama cuando el puntero del mouse sale de la celda.
OnMouseMove(DataGridViewCellMouseEventArgs)	Se llama cuando el puntero del mouse se mueve dentro de una celda.
OnMouseUp(DataGridViewCellMouseEventArgs)	Se llama cuando el usuario suelta un botón del mouse mientras el puntero está en una celda.
Paint(Graphics, Rectangle, Rectangle, Int32, DataGridViewElementStates, Object, Object, String, DataGridViewCellStyle, DataGridViewAdvancedBorderStyle, DataGridViewPaintParts)	Pinta el objeto actual DataGridViewCell.
PaintBorder(Graphics, Rectangle, Rectangle, DataGridViewCellStyle, DataGridViewAdvancedBorderStyle)	Pinta el borde del objeto actual DataGridViewCell.
PaintErrorIcon(Graphics, Rectangle, Rectangle, String)	Pinta el icono de error del objeto actual DataGridViewCell.
ParseFormattedValue(Object, DataGridViewCellStyle, TypeConverter, TypeConverter)	Convierte un valor con formato para mostrar en un valor de celda real.
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.
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.
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.
ToString()	Devuelve una cadena que describe el objeto actual.

Consulte también

• DataGridView
• ICloneable
• IDisposable