DataGridViewCell Clase

Definición

Representa una celda individual de un control DataGridView.Represents an individual cell in a 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
type DataGridViewCell = class
    inherit DataGridViewElement
    interface ICloneable
    interface IDisposable
Public MustInherit Class DataGridViewCell
Inherits DataGridViewElement
Implements ICloneable, IDisposable
Herencia
DataGridViewCell
Derivado
Atributos
Implementaciones

Ejemplos

En el ejemplo de código siguiente se muestra el uso de este tipo.The following code example illustrates the use of this type. Para obtener más información acerca de este ejemplo, vea cómo: Agregar información sobre herramientas a celdas individuales en un control Windows Forms DataGridView.For more information about this example, see 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 clase DataGridViewCell representa una celda individual de un control DataGridView.The DataGridViewCell class represents an individual cell in a DataGridView control. Puede recuperar las celdas a través de la colección de Cells de una DataGridViewRow.You can retrieve cells through the Cells collection of a DataGridViewRow.

La fila y la columna de un DataGridViewCell identificar la ubicación de la celda en el DataGridView.The row and column for a DataGridViewCell identify the cell's location in the DataGridView. Una celda típica contiene datos específicos de la fila y la columna en la que se encuentran.A typical cell contains data specific to the row and column in which it is contained. La celda se puede personalizar de varias maneras estableciendo sus propiedades y controlando los eventos asociados a ella.The cell can be customized in a number of ways by setting its properties and handling the events associated with it.

Notas a los desarrolladores de herederos

Al derivar de DataGridViewCell y agregar nuevas propiedades a la clase derivada, asegúrese de invalidar el método Clone() para copiar las nuevas propiedades durante las operaciones de clonación.When you derive from DataGridViewCell and add new properties to the derived class, be sure to override the Clone() method to copy the new properties during cloning operations. 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.You should also call the base class's Clone() method so that the properties of the base class are copied to the new cell.

Constructores

DataGridViewCell()

Inicializa una nueva instancia de la clase DataGridViewCell.Initializes a new instance of the DataGridViewCell class.

Propiedades

AccessibilityObject

Obtiene el objeto DataGridViewCell.DataGridViewCellAccessibleObject asignado a DataGridViewCell.Gets the DataGridViewCell.DataGridViewCellAccessibleObject assigned to the DataGridViewCell.

ColumnIndex

Obtiene el índice de columna de esta celda.Gets the column index for this cell.

ContentBounds

Obtiene el rectángulo delimitador que rodea el área de contenido de la celda.Gets the bounding rectangle that encloses the cell's content area.

ContextMenuStrip

Obtiene o establece el menú contextual asociado a la celda.Gets or sets the shortcut menu associated with the cell.

DataGridView

Obtiene el control DataGridView asociado a este elemento.Gets the DataGridView control associated with this element.

(Heredado de DataGridViewElement)
DefaultNewRowValue

Obtiene el valor predeterminado de una celda de la fila de nuevos registros.Gets the default value for a cell in the row for new records.

Displayed

Obtiene un valor que indica si la celda se muestra actualmente en pantalla.Gets a value that indicates whether the cell is currently displayed on-screen.

EditedFormattedValue

Obtiene el valor actual con formato de la celda, con independencia de si la celda está en modo de edición y no se ha confirmado el valor.Gets the current, formatted value of the cell, regardless of whether the cell is in edit mode and the value has not been committed.

EditType

Obtiene el tipo del control de edición hospedado de la celda.Gets the type of the cell's hosted editing control.

ErrorIconBounds

Obtiene los límites del icono de error para la celda.Gets the bounds of the error icon for the cell.

ErrorText

Obtiene o establece el texto que describe una condición de error asociada a la celda.Gets or sets the text describing an error condition associated with the cell.

FormattedValue

Obtiene el valor de la celda con el formato para mostrar.Gets the value of the cell as formatted for display.

FormattedValueType

Obtiene el tipo del valor con formato asociado a la celda.Gets the type of the formatted value associated with the cell.

Frozen

Obtiene un valor que indica si la celda está inmovilizada.Gets a value indicating whether the cell is frozen.

HasStyle

Obtiene un valor que indica si se ha establecido la propiedad Style.Gets a value indicating whether the Style property has been set.

InheritedState

Obtiene el estado actual de la celda tal como lo hereda del estado de su fila y columna.Gets the current state of the cell as inherited from the state of its row and column.

InheritedStyle

Obtiene el estilo aplicado actualmente a la celda.Gets the style currently applied to the cell.

IsInEditMode

Obtiene un valor que indica si actualmente se está editando la celda.Gets a value indicating whether this cell is currently being edited.

OwningColumn

Obtiene la columna que contiene esta celda.Gets the column that contains this cell.

OwningRow

Obtiene la fila que contiene esta celda.Gets the row that contains this cell.

PreferredSize

Obtiene el tamaño, en píxeles, de un área rectangular en la que cabe la celda.Gets the size, in pixels, of a rectangular area into which the cell can fit.

ReadOnly

Obtiene o establece un valor que indica si se pueden editar los datos de la celda.Gets or sets a value indicating whether the cell's data can be edited.

Resizable

Obtiene un valor que indica si se puede cambiar el tamaño de la celda.Gets a value indicating whether the cell can be resized.

RowIndex

Obtiene el índice de la fila primaria de la celda.Gets the index of the cell's parent row.

Selected

Obtiene o establece un valor que indica si se ha seleccionado la celda.Gets or sets a value indicating whether the cell has been selected.

Size

Obtiene el tamaño de la celda.Gets the size of the cell.

State

Obtiene el estado de la interfaz de usuario del elemento.Gets the user interface (UI) state of the element.

(Heredado de DataGridViewElement)
Style

Obtiene o establece el estilo de la celda.Gets or sets the style for the cell.

Tag

Obtiene o establece el objeto que contiene datos complementarios sobre la celda.Gets or sets the object that contains supplemental data about the cell.

ToolTipText

Obtiene o establece el texto de información sobre herramientas asociado a esta celda.Gets or sets the ToolTip text associated with this cell.

Value

Obtiene o establece el valor asociado a esta celda.Gets or sets the value associated with this cell.

ValueType

Obtiene o establece el tipo de datos de los valores de la celda.Gets or sets the data type of the values in the cell.

Visible

Obtiene un valor que indica si la celda está en una fila o columna que se ha ocultado.Gets a value indicating whether the cell is in a row or column that has been hidden.

Métodos

AdjustCellBorderStyle(DataGridViewAdvancedBorderStyle, DataGridViewAdvancedBorderStyle, Boolean, Boolean, Boolean, Boolean)

Modifica el estilo de borde de celda de entrada según los criterios especificados.Modifies the input cell border style according to the specified criteria.

BorderWidths(DataGridViewAdvancedBorderStyle)

Devuelve un objeto Rectangle que representa el ancho de todos los márgenes de la celda.Returns a Rectangle that represents the widths of all the cell margins.

ClickUnsharesRow(DataGridViewCellEventArgs)

Indica si la fila de la celda dejará de estar compartida al hacer clic en la celda.Indicates whether the cell's row will be unshared when the cell is clicked.

Clone()

Crea una copia exacta de esta celda.Creates an exact copy of this cell.

ContentClickUnsharesRow(DataGridViewCellEventArgs)

Indica si la fila de la celda dejará de estar compartida al hacer clic en el contenido de la celda.Indicates whether the cell's row will be unshared when the cell's content is clicked.

ContentDoubleClickUnsharesRow(DataGridViewCellEventArgs)

Indica si la fila de la celda dejará de estar compartida al hacer doble clic en el contenido de la celda.Indicates whether the cell's row will be unshared when the cell's content is double-clicked.

CreateAccessibilityInstance()

Crea un nuevo objeto accesible para el control DataGridViewCell.Creates a new accessible object for the DataGridViewCell.

DetachEditingControl()

Quita el control de edición de la celda de DataGridView.Removes the cell's editing control from the DataGridView.

Dispose()

Libera todos los recursos que usa DataGridViewCell.Releases all resources used by the DataGridViewCell.

Dispose(Boolean)

Libera los recursos no administrados que usa DataGridViewCell y, de forma opcional, libera los recursos administrados.Releases the unmanaged resources used by the DataGridViewCell and optionally releases the managed resources.

DoubleClickUnsharesRow(DataGridViewCellEventArgs)

Indica si la fila de la celda dejará de estar compartida al hacer doble clic en la celda.Indicates whether the cell's row will be unshared when the cell is double-clicked.

EnterUnsharesRow(Int32, Boolean)

Indica si la fila primaria va a dejar de estar compartida cuando el foco se desplace a la celda.Indicates whether the parent row will be unshared when the focus moves to the cell.

Equals(Object)

Determina si el objeto especificado es igual al objeto actual.Determines whether the specified object is equal to the current object.

(Heredado de Object)
Finalize()

Libera los recursos no administrados y realiza otras operaciones de limpieza antes de que la recolección de elementos no utilizados reclame DataGridViewCell.Releases the unmanaged resources and performs other cleanup operations before the DataGridViewCell is reclaimed by garbage collection.

GetClipboardContent(Int32, Boolean, Boolean, Boolean, Boolean, String)

Recupera el valor con formato de la celda que copiar en el Clipboard.Retrieves the formatted value of the cell to copy to the Clipboard.

GetContentBounds(Graphics, DataGridViewCellStyle, Int32)

Devuelve el rectángulo delimitador que rodea el área de contenido de la celda, que se calcula utilizando el objeto Graphics especificado y el estilo de celda.Returns the bounding rectangle that encloses the cell's content area, which is calculated using the specified Graphics and cell style.

GetContentBounds(Int32)

Devuelve el rectángulo delimitador que rodea el área de contenido de la celda utilizando un objeto Graphics predeterminado y el estilo de celda actualmente en vigor para la celda.Returns the bounding rectangle that encloses the cell's content area using a default Graphics and cell style currently in effect for the cell.

GetEditedFormattedValue(Int32, DataGridViewDataErrorContexts)

Devuelve el valor actual con formato de la celda, con independencia de si la celda está en modo de edición y no se ha confirmado el valor.Returns the current, formatted value of the cell, regardless of whether the cell is in edit mode and the value has not been committed.

GetErrorIconBounds(Graphics, DataGridViewCellStyle, Int32)

Devuelve el rectángulo delimitador que rodea el icono de error de la celda, si se está mostrando alguna.Returns the bounding rectangle that encloses the cell's error icon, if one is displayed.

GetErrorText(Int32)

Devuelve una cadena que representa el error para la celda.Returns a string that represents the error for the cell.

GetFormattedValue(Object, Int32, DataGridViewCellStyle, TypeConverter, TypeConverter, DataGridViewDataErrorContexts)

Obtiene el valor de la celda con el formato para mostrar.Gets the value of the cell as formatted for display.

GetHashCode()

Sirve como la función hash predeterminada.Serves as the default hash function.

(Heredado de Object)
GetInheritedContextMenuStrip(Int32)

Obtiene el menú contextual heredado para la celda actual.Gets the inherited shortcut menu for the current cell.

GetInheritedState(Int32)

Devuelve un valor que indica el estado actual de la celda tal como lo hereda del estado de su fila y columna.Returns a value indicating the current state of the cell as inherited from the state of its row and column.

GetInheritedStyle(DataGridViewCellStyle, Int32, Boolean)

Obtiene el estilo aplicado a la celda.Gets the style applied to the cell.

GetPreferredSize(Graphics, DataGridViewCellStyle, Int32, Size)

Calcula el tamaño preferido, en píxeles, de la celda.Calculates the preferred size, in pixels, of the cell.

GetSize(Int32)

Obtiene el tamaño de la celda.Gets the size of the cell.

GetType()

Obtiene el Type de la instancia actual.Gets the Type of the current instance.

(Heredado de Object)
GetValue(Int32)

Obtiene el valor de la celda.Gets the value of the cell.

InitializeEditingControl(Int32, Object, DataGridViewCellStyle)

Inicializa el control utilizado para editar la celda.Initializes the control used to edit the cell.

KeyDownUnsharesRow(KeyEventArgs, Int32)

Indica si la fila primaria deja de estar compartida cuando el usuario presiona una tecla mientras el foco está en la celda.Indicates whether the parent row is unshared if the user presses a key while the focus is on the cell.

KeyEntersEditMode(KeyEventArgs)

Determina si el modo de edición se debe iniciar basándose en la clave dada.Determines if edit mode should be started based on the given key.

KeyPressUnsharesRow(KeyPressEventArgs, Int32)

Indica si una fila va a dejar de estar compartida cuando se presiona una tecla mientras el foco está en una celda de la fila.Indicates whether a row will be unshared if a key is pressed while a cell in the row has focus.

KeyUpUnsharesRow(KeyEventArgs, Int32)

Indica si la fila primaria deja de estar compartida cuando el usuario libera una tecla mientras el foco está en la celda.Indicates whether the parent row is unshared when the user releases a key while the focus is on the cell.

LeaveUnsharesRow(Int32, Boolean)

Indica si una fila va a dejar de estar compartida cuando el foco abandone una celda de la fila.Indicates whether a row will be unshared when the focus leaves a cell in the row.

MeasureTextHeight(Graphics, String, Font, Int32, TextFormatFlags)

Obtiene el alto, en píxeles, del texto especificado en función de las características que se indiquen.Gets the height, in pixels, of the specified text, given the specified characteristics.

MeasureTextHeight(Graphics, String, Font, Int32, TextFormatFlags, Boolean)

Obtiene el alto, en píxeles, del texto especificado en función de las características que se indiquen.Gets the height, in pixels, of the specified text, given the specified characteristics. También indica si el ancho necesario es mayor que el ancho máximo especificado.Also indicates whether the required width is greater than the specified maximum width.

MeasureTextPreferredSize(Graphics, String, Font, Single, TextFormatFlags)

Obtiene el alto y ancho ideales del texto especificado en función de las características que se indiquen.Gets the ideal height and width of the specified text given the specified characteristics.

MeasureTextSize(Graphics, String, Font, TextFormatFlags)

Obtiene el alto y ancho del texto especificado en función de las características que se indiquen.Gets the height and width of the specified text given the specified characteristics.

MeasureTextWidth(Graphics, String, Font, Int32, TextFormatFlags)

Obtiene el ancho, en píxeles, del texto especificado en función de las características que se indiquen.Gets the width, in pixels, of the specified text given the specified characteristics.

MemberwiseClone()

Crea una copia superficial del objeto Object actual.Creates a shallow copy of the current Object.

(Heredado de Object)
MouseClickUnsharesRow(DataGridViewCellMouseEventArgs)

Indica si una fila va a dejar de estar compartida cuando el usuario haga clic en un botón del mouse mientras el puntero está en una celda de la fila.Indicates whether a row will be unshared if the user clicks a mouse button while the pointer is on a cell in the row.

MouseDoubleClickUnsharesRow(DataGridViewCellMouseEventArgs)

Indica si una fila va a dejar de estar compartida cuando el usuario haga doble clic en una celda de la fila.Indicates whether a row will be unshared if the user double-clicks a cell in the row.

MouseDownUnsharesRow(DataGridViewCellMouseEventArgs)

Indica si una fila va a dejar de estar compartida cuando el usuario mantiene presionado un botón del mouse mientras el puntero está en una celda de la fila.Indicates whether a row will be unshared when the user holds down a mouse button while the pointer is on a cell in the row.

MouseEnterUnsharesRow(Int32)

Indica si una fila va a dejar de estar compartida cuando el puntero del mouse se sitúe sobre una celda de la fila.Indicates whether a row will be unshared when the mouse pointer moves over a cell in the row.

MouseLeaveUnsharesRow(Int32)

Indica si una fila va a dejar de estar compartida cuando el puntero del mouse salga de la fila.Indicates whether a row will be unshared when the mouse pointer leaves the row.

MouseMoveUnsharesRow(DataGridViewCellMouseEventArgs)

Indica si una fila va a dejar de estar compartida cuando el puntero del mouse se sitúe sobre una celda de la fila.Indicates whether a row will be unshared when the mouse pointer moves over a cell in the row.

MouseUpUnsharesRow(DataGridViewCellMouseEventArgs)

Indica si una fila va a dejar de estar compartida cuando el usuario suelte un botón del mouse mientras el puntero está en una celda de la fila.Indicates whether a row will be unshared when the user releases a mouse button while the pointer is on a cell in the row.

OnClick(DataGridViewCellEventArgs)

Se le llama al hacer clic en la celda.Called when the cell is clicked.

OnContentClick(DataGridViewCellEventArgs)

Se le llama al hacer clic en el contenido de la celda.Called when the cell's contents are clicked.

OnContentDoubleClick(DataGridViewCellEventArgs)

Se le llama al hacer doble clic en el contenido de la celda.Called when the cell's contents are double-clicked.

OnDataGridViewChanged()

Se le llama cuando cambia la propiedad DataGridView de la celda.Called when the DataGridView property of the cell changes.

OnDoubleClick(DataGridViewCellEventArgs)

Se le llama al hacer doble clic en la celda.Called when the cell is double-clicked.

OnEnter(Int32, Boolean)

Se le llama cuando el foco se desplaza a una celda.Called when the focus moves to a cell.

OnKeyDown(KeyEventArgs, Int32)

Se le llama cuando se presiona una tecla de carácter mientras el foco está en una celda.Called when a character key is pressed while the focus is on a cell.

OnKeyPress(KeyPressEventArgs, Int32)

Se le llama cuando se presiona una tecla mientras el foco está en una celda.Called when a key is pressed while the focus is on a cell.

OnKeyUp(KeyEventArgs, Int32)

Se le llama cuando se suelta una tecla de carácter mientras el foco está en una celda.Called when a character key is released while the focus is on a cell.

OnLeave(Int32, Boolean)

Se le llama cuando el foco se desplaza de una celda.Called when the focus moves from a cell.

OnMouseClick(DataGridViewCellMouseEventArgs)

Se llama cuando el usuario hace clic en un botón del mouse mientras el puntero está en una celda.Called when the user clicks a mouse button while the pointer is on a cell.

OnMouseDoubleClick(DataGridViewCellMouseEventArgs)

Se le llama cuando el usuario hace doble clic en un botón del mouse mientras el puntero está en una celda.Called when the user double-clicks a mouse button while the pointer is on a cell.

OnMouseDown(DataGridViewCellMouseEventArgs)

Se le llama cuando el usuario mantiene presionado un botón del mouse mientras el puntero está en una celda.Called when the user holds down a mouse button while the pointer is on a cell.

OnMouseEnter(Int32)

Se le llama cuando el puntero del mouse se mueve sobre una celda.Called when the mouse pointer moves over a cell.

OnMouseLeave(Int32)

Se le llama cuando el puntero del mouse sale de la celda.Called when the mouse pointer leaves the cell.

OnMouseMove(DataGridViewCellMouseEventArgs)

Se le llama cuando el puntero del mouse se mueve dentro de una celda.Called when the mouse pointer moves within a cell.

OnMouseUp(DataGridViewCellMouseEventArgs)

Se le llama cuando el usuario suelta un botón del mouse mientras el puntero está en una celda.Called when the user releases a mouse button while the pointer is on a cell.

Paint(Graphics, Rectangle, Rectangle, Int32, DataGridViewElementStates, Object, Object, String, DataGridViewCellStyle, DataGridViewAdvancedBorderStyle, DataGridViewPaintParts)

Pinta el objeto DataGridViewCell actual.Paints the current DataGridViewCell.

PaintBorder(Graphics, Rectangle, Rectangle, DataGridViewCellStyle, DataGridViewAdvancedBorderStyle)

Dibuja el borde de la clase DataGridViewCell actual.Paints the border of the current DataGridViewCell.

PaintErrorIcon(Graphics, Rectangle, Rectangle, String)

Dibuja el icono de error del control DataGridViewCell actual.Paints the error icon of the current DataGridViewCell.

ParseFormattedValue(Object, DataGridViewCellStyle, TypeConverter, TypeConverter)

Convierte un valor con formato para la presentación en un valor de celda real.Converts a value formatted for display to an actual cell value.

PositionEditingControl(Boolean, Boolean, Rectangle, Rectangle, DataGridViewCellStyle, Boolean, Boolean, Boolean, Boolean)

Establece la ubicación y tamaño del control de edición que hospeda una celda del control DataGridView.Sets the location and size of the editing control hosted by a cell in the DataGridView control.

PositionEditingPanel(Rectangle, Rectangle, DataGridViewCellStyle, Boolean, Boolean, Boolean, Boolean)

Establece la ubicación y 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.Sets the location and size of the editing panel hosted by the cell, and returns the normal bounds of the editing control within the editing panel.

RaiseCellClick(DataGridViewCellEventArgs)

Genera el evento CellClick.Raises the CellClick event.

(Heredado de DataGridViewElement)
RaiseCellContentClick(DataGridViewCellEventArgs)

Genera el evento CellContentClick.Raises the CellContentClick event.

(Heredado de DataGridViewElement)
RaiseCellContentDoubleClick(DataGridViewCellEventArgs)

Genera el evento CellContentDoubleClick.Raises the CellContentDoubleClick event.

(Heredado de DataGridViewElement)
RaiseCellValueChanged(DataGridViewCellEventArgs)

Genera el evento CellValueChanged.Raises the CellValueChanged event.

(Heredado de DataGridViewElement)
RaiseDataError(DataGridViewDataErrorEventArgs)

Genera el evento DataError.Raises the DataError event.

(Heredado de DataGridViewElement)
RaiseMouseWheel(MouseEventArgs)

Genera el evento MouseWheel.Raises the MouseWheel event.

(Heredado de DataGridViewElement)
SetValue(Int32, Object)

Establece el valor de la celda.Sets the value of the cell.

ToString()

Devuelve una cadena que describe el objeto actual.Returns a string that describes the current object.

Se aplica a

Consulte también: