DataGridViewCell Clase
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
Representa una celda individual de un control DataGridView.
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 IDisposablePublic MustInherit Class DataGridViewCell
Inherits DataGridViewElement
Implements ICloneable, IDisposable- Herencia
- Derivado
- Atributos
- Implementaciones
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 se encuentra. La celda se puede personalizar de varias maneras estableciendo sus propiedades y controlando los eventos asociados a ella.
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
| DataGridViewCell() |
Inicializa una nueva instancia de la clase DataGridViewCell. |
Propiedades
| AccessibilityObject |
Obtiene el objeto DataGridViewCell.DataGridViewCellAccessibleObject asignado a DataGridViewCell. |
| ColumnIndex |
Obtiene el índice de columna de esta celda. |
| ContentBounds |
Obtiene el rectángulo delimitador que rodea el área de contenido de la celda. |
| ContextMenuStrip |
Obtiene o establece el menú contextual asociado a la celda. |
| DataGridView |
Obtiene el control DataGridView asociado a este elemento. (Heredado de DataGridViewElement) |
| DefaultNewRowValue |
Obtiene el valor predeterminado de una celda de la fila de nuevos registros. |
| Displayed |
Obtiene un valor que indica si la celda se muestra actualmente en pantalla. |
| 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. |
| EditType |
Obtiene el tipo del control de edición hospedado de la celda. |
| ErrorIconBounds |
Obtiene los límites del icono de error para 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 el 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 propiedad Style. |
| InheritedState |
Obtiene el estado actual de la celda tal como lo hereda del estado de su fila y columna. |
| InheritedStyle |
Obtiene el estilo aplicado actualmente a la celda. |
| IsInEditMode |
Obtiene un valor que indica si actualmente se está editando la celda. |
| 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 cabe 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 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
| 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 objeto Rectangle que representa el ancho de todos los márgenes de la celda. |
| ClickUnsharesRow(DataGridViewCellEventArgs) |
Indica si la fila de la celda dejará de estar compartida al hacer clic en la celda. |
| Clone() |
Crea una copia exacta de esta celda. |
| ContentClickUnsharesRow(DataGridViewCellEventArgs) |
Indica si la fila de la celda dejará de estar compartida al hacer clic en el contenido de la celda. |
| ContentDoubleClickUnsharesRow(DataGridViewCellEventArgs) |
Indica si la fila de la celda dejará de estar compartida al hacer doble clic en el contenido de la celda. |
| CreateAccessibilityInstance() |
Crea un nuevo objeto accesible para el control DataGridViewCell. |
| DetachEditingControl() |
Quita el control de edición de la celda de DataGridView. |
| Dispose() |
Libera todos los recursos que usa DataGridViewCell. |
| Dispose(Boolean) |
Libera los recursos no administrados que usa DataGridViewCell y, de forma opcional, libera los recursos administrados. |
| DoubleClickUnsharesRow(DataGridViewCellEventArgs) |
Indica si la fila de la celda dejará de estar compartida al hacer doble clic en la celda. |
| EnterUnsharesRow(Int32, Boolean) |
Indica si la fila primaria va a dejar de estar compartida cuando el foco se desplace a la celda. |
| Equals(Object) |
Determina si el objeto especificado es igual que el objeto actual. (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. |
| GetClipboardContent(Int32, Boolean, Boolean, Boolean, Boolean, String) |
Recupera el valor con formato de la celda que copiar en el Clipboard. |
| GetContentBounds(Graphics, DataGridViewCellStyle, Int32) |
Devuelve el rectángulo delimitador que rodea el área de contenido de la celda, que se calcula mediante la clase Graphics y el estilo de celda especificados. |
| 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. |
| 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. |
| GetErrorIconBounds(Graphics, DataGridViewCellStyle, Int32) |
Devuelve el rectángulo delimitador que rodea el icono de error de la celda, si se está mostrando. |
| GetErrorText(Int32) |
Devuelve una cadena que representa el error para la celda. |
| GetFormattedValue(Object, Int32, DataGridViewCellStyle, TypeConverter, TypeConverter, DataGridViewDataErrorContexts) |
Obtiene el valor de la celda con el formato para mostrar. |
| GetHashCode() |
Sirve como la función hash predeterminada. (Heredado de Object) |
| GetInheritedContextMenuStrip(Int32) |
Obtiene el menú contextual heredado para la celda actual. |
| GetInheritedState(Int32) |
Devuelve un valor que indica el estado actual de la celda tal como lo hereda 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 utilizado para editar la celda. |
| 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. |
| KeyEntersEditMode(KeyEventArgs) |
Determina si el modo de edición se debe iniciar basándose en la clave dada. |
| 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. |
| 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. |
| LeaveUnsharesRow(Int32, Boolean) |
Indica si una fila va a dejar de estar compartida cuando el foco abandone una celda de la fila. |
| 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. |
| 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. También indica si el ancho necesario es mayor que el ancho máximo especificado. |
| 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. |
| MeasureTextSize(Graphics, String, Font, TextFormatFlags) |
Obtiene el alto y ancho del texto especificado en función de las características que se indiquen. |
| 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. |
| MemberwiseClone() |
Crea una copia superficial del Object actual. (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. |
| MouseDoubleClickUnsharesRow(DataGridViewCellMouseEventArgs) |
Indica si una fila va a dejar de estar compartida cuando el usuario haga doble clic en una celda de la fila. |
| 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. |
| 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. |
| MouseLeaveUnsharesRow(Int32) |
Indica si una fila va a dejar de estar compartida cuando el puntero del mouse salga de la fila. |
| 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. |
| 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. |
| OnClick(DataGridViewCellEventArgs) |
Se le llama al hacer clic en la celda. |
| OnContentClick(DataGridViewCellEventArgs) |
Se le llama al hacer clic en el contenido de la celda. |
| OnContentDoubleClick(DataGridViewCellEventArgs) |
Se le llama al hacer doble clic en el contenido de la celda. |
| OnDataGridViewChanged() |
Se le llama cuando cambia la propiedad DataGridView de la celda. |
| OnDoubleClick(DataGridViewCellEventArgs) |
Se le llama al hacer doble clic en la celda. |
| OnEnter(Int32, Boolean) |
Se le llama cuando el foco se desplaza a una celda. |
| OnKeyDown(KeyEventArgs, Int32) |
Se le llama cuando se presiona una tecla de carácter mientras el foco está en una celda. |
| OnKeyPress(KeyPressEventArgs, Int32) |
Se le llama cuando se presiona una tecla mientras el foco está en una celda. |
| OnKeyUp(KeyEventArgs, Int32) |
Se le llama cuando se suelta una tecla de carácter mientras el foco está en una celda. |
| OnLeave(Int32, Boolean) |
Se le llama cuando el foco se desplaza 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 le llama cuando el usuario hace doble clic en un botón del mouse mientras el puntero está en una celda. |
| OnMouseDown(DataGridViewCellMouseEventArgs) |
Se le llama cuando el usuario mantiene presionado un botón del mouse mientras el puntero está en una celda. |
| OnMouseEnter(Int32) |
Se le llama cuando el puntero del mouse se mueve sobre una celda. |
| OnMouseLeave(Int32) |
Se le llama cuando el puntero del mouse sale de la celda. |
| OnMouseMove(DataGridViewCellMouseEventArgs) |
Se le llama cuando el puntero del mouse se mueve dentro de una celda. |
| OnMouseUp(DataGridViewCellMouseEventArgs) |
Se le 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 DataGridViewCell actual. |
| PaintBorder(Graphics, Rectangle, Rectangle, DataGridViewCellStyle, DataGridViewAdvancedBorderStyle) |
Dibuja el borde de la clase DataGridViewCell actual. |
| PaintErrorIcon(Graphics, Rectangle, Rectangle, String) |
Dibuja el icono de error del control DataGridViewCell actual. |
| ParseFormattedValue(Object, DataGridViewCellStyle, TypeConverter, TypeConverter) |
Convierte un valor con formato para la presentación en un valor de celda real. |
| 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. |
| 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. |
| 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. |
