Página de inicio Biblioteca Aprender Descargas Soporte técnico Comunidad
Iniciar sesión | United States - English | |
Este artículo se tradujo de forma manual. Mueva el puntero sobre las frases del artículo para ver el texto original.
Traducción
Original
Este tema aún no ha recibido ninguna valoración Valorar este tema

DataGridViewCell (Clase)

.NET Framework 4

Representa una celda individual de un control DataGridView.

System.Object
  System.Windows.Forms.DataGridViewElement
    System.Windows.Forms.DataGridViewCell
      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

Espacio de nombres:  System.Windows.Forms
Ensamblado:  System.Windows.Forms (en System.Windows.Forms.dll)
C#
C++
F#
VB
Copiar 
public abstract class DataGridViewCell : DataGridViewElement, 
	ICloneable, IDisposable

El tipo DataGridViewCell expone los siguientes miembros.

  Nombre Descripción
Método protegido DataGridViewCell Inicializa una nueva instancia de la clase DataGridViewCell.
Arriba
  Nombre Descripción
Propiedad pública AccessibilityObject Obtiene el objeto DataGridViewCell.DataGridViewCellAccessibleObject asignado a DataGridViewCell.
Propiedad pública ColumnIndex Obtiene el índice de columna de esta celda.
Propiedad pública ContentBounds Obtiene el rectángulo delimitador que rodea el área de contenido de la celda.
Propiedad pública ContextMenuStrip Obtiene o establece el menú contextual asociado a la celda.
Propiedad pública DataGridView Obtiene el control DataGridView asociado a este elemento. (Se hereda de DataGridViewElement).
Propiedad pública DefaultNewRowValue Obtiene el valor predeterminado de una celda de la fila de nuevos registros.
Propiedad pública Displayed Obtiene un valor que indica si la celda se muestra actualmente en pantalla.
Propiedad pública 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.
Propiedad pública EditType Obtiene el tipo del control de edición hospedado de la celda.
Propiedad pública ErrorIconBounds Obtiene los límites del icono de error para la celda.
Propiedad pública ErrorText Obtiene o establece el texto que describe una condición de error asociada a la celda.
Propiedad pública FormattedValue Obtiene el valor de la celda con el formato para mostrar.
Propiedad pública FormattedValueType Obtiene el tipo del valor con formato asociado a la celda.
Propiedad pública Frozen Obtiene un valor que indica si la celda está inmovilizada.
Propiedad pública HasStyle Obtiene un valor que indica si se ha establecido la propiedad Style.
Propiedad pública InheritedState Obtiene el estado actual de la celda tal como lo hereda del estado de su fila y columna.
Propiedad pública InheritedStyle Obtiene el estilo aplicado actualmente a la celda.
Propiedad pública IsInEditMode Obtiene un valor que indica si actualmente se está editando la celda.
Propiedad pública OwningColumn Obtiene la columna que contiene esta celda.
Propiedad pública OwningRow Obtiene la fila que contiene esta celda.
Propiedad pública PreferredSize Obtiene el tamaño, en píxeles, de un área rectangular en la que cabe la celda.
Propiedad pública ReadOnly Obtiene o establece un valor que indica si se pueden editar los datos de la celda.
Propiedad pública Resizable Obtiene un valor que indica si se puede cambiar el tamaño de la celda.
Propiedad pública RowIndex Obtiene el índice de la fila primaria de la celda.
Propiedad pública Selected Obtiene o establece un valor que indica si se ha seleccionado la celda.
Propiedad pública Size Obtiene el tamaño de la celda.
Propiedad pública State Obtiene el estado de la interfaz de usuario del elemento. (Se hereda de DataGridViewElement).
Propiedad pública Style Obtiene o establece el estilo de la celda.
Propiedad pública Tag Obtiene o establece el objeto que contiene datos complementarios sobre la celda.
Propiedad pública ToolTipText Obtiene o establece el texto de información sobre herramientas asociado a esta celda.
Propiedad pública Value Obtiene o establece el valor asociado a esta celda.
Propiedad pública ValueType Obtiene o establece el tipo de datos de los valores de la celda.
Propiedad pública Visible Obtiene un valor que indica si la celda está en una fila o columna que se ha ocultado.
Arriba
  Nombre Descripción
Método público AdjustCellBorderStyle Modifica el estilo de borde de celda de entrada según los criterios especificados.
Método protegido BorderWidths Devuelve un objeto Rectangle que representa el ancho de todos los márgenes de la celda.
Método protegido ClickUnsharesRow Indica si la fila de la celda dejará de estar compartida al hacer clic en la celda.
Método público Clone Crea una copia exacta de esta celda.
Método protegido ContentClickUnsharesRow Indica si la fila de la celda dejará de estar compartida al hacer clic en el contenido de la celda.
Método protegido ContentDoubleClickUnsharesRow Indica si la fila de la celda dejará de estar compartida al hacer doble clic en el contenido de la celda.
Método protegido CreateAccessibilityInstance Crea un nuevo objeto accesible para la celda DataGridViewCell.
Método público DetachEditingControl Quita el control de edición de la celda de DataGridView.
Método público Dispose Libera todos los recursos utilizados por el objeto DataGridViewCell.
Método protegido Dispose(Boolean) Libera los recursos no administrados que utiliza DataGridViewCell y, opcionalmente, libera los recursos administrados.
Método protegido DoubleClickUnsharesRow Indica si la fila de la celda dejará de estar compartida al hacer doble clic en la celda.
Método protegido EnterUnsharesRow Indica si la fila primaria va a dejar de estar compartida cuando el foco se desplace a la celda.
Método público Equals(Object) Determina si el objeto Object especificado es igual al objeto Object actual. (Se hereda de Object).
Método protegido Finalize Libera los recursos no administrados y realiza otras operaciones de limpieza antes de que el recolector de elementos no utilizados reclame DataGridViewCell. (Invalida a Object.Finalize).
Método protegido GetClipboardContent Recupera el valor con formato de la celda que copiar en el Clipboard.
Método público 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.
Método protegido 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.
Método público GetEditedFormattedValue 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.
Método protegido GetErrorIconBounds Devuelve el rectángulo delimitador que rodea el icono de error de la celda, si se muestra alguno.
Método protegido GetErrorText Devuelve una cadena que representa el error para la celda.
Método protegido GetFormattedValue Obtiene el valor de la celda con el formato para mostrar.
Método público GetHashCode Actúa como función hash para un tipo concreto. (Se hereda de Object).
Método público GetInheritedContextMenuStrip Obtiene el menú contextual heredado para la celda actual.
Método público GetInheritedState Devuelve un valor que indica el estado actual de la celda tal como lo hereda del estado de su fila y columna.
Método público GetInheritedStyle Obtiene el estilo aplicado a la celda.
Método protegido GetPreferredSize Calcula el tamaño preferido, en píxeles, de la celda.
Método protegido GetSize Obtiene el tamaño de la celda.
Método público GetType Obtiene el objeto Type de la instancia actual. (Se hereda de Object).
Método protegido GetValue Obtiene el valor de la celda.
Método público InitializeEditingControl Inicializa el control utilizado para editar la celda.
Método protegido KeyDownUnsharesRow Indica si la fila primaria deja de estar compartida cuando el usuario presiona una tecla mientras el foco está en la celda.
Método público KeyEntersEditMode Determina si el modo de edición se debe iniciar basándose en la clave dada.
Método protegido KeyPressUnsharesRow 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.
Método protegido KeyUpUnsharesRow Indica si la fila primaria deja de estar compartida cuando el usuario libera una tecla mientras el foco está en la celda.
Método protegido LeaveUnsharesRow Indica si una fila va a dejar de estar compartida cuando el foco abandone una celda de la fila.
Método público Miembro estático 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.
Método público Miembro estático 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.
Método público Miembro estático MeasureTextPreferredSize Obtiene el alto y ancho ideales del texto especificado en función de las características que se indiquen.
Método público Miembro estático MeasureTextSize Obtiene el alto y ancho del texto especificado en función de las características que se indiquen.
Método público Miembro estático MeasureTextWidth Obtiene el ancho, en píxeles, del texto especificado en función de las características que se indiquen.
Método protegido MemberwiseClone Crea una copia superficial del objeto Object actual. (Se hereda de Object).
Método protegido MouseClickUnsharesRow 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.
Método protegido MouseDoubleClickUnsharesRow Indica si una fila va a dejar de estar compartida cuando el usuario haga doble clic en una celda de la fila.
Método protegido MouseDownUnsharesRow 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.
Método protegido MouseEnterUnsharesRow Indica si una fila va a dejar de estar compartida cuando el puntero del mouse se sitúe sobre una celda de la fila.
Método protegido MouseLeaveUnsharesRow Indica si una fila va a dejar de estar compartida cuando el puntero del mouse salga de la fila.
Método protegido MouseMoveUnsharesRow Indica si una fila va a dejar de estar compartida cuando el puntero del mouse se sitúe sobre una celda de la fila.
Método protegido MouseUpUnsharesRow Indica si una fila va a dejar de estar compartida cuando el usuario suelta un botón del mouse mientras el puntero está en una celda de la fila.
Método protegido OnClick Se le llama al hacer clic en la celda.
Método protegido OnContentClick Se le llama al hacer clic en el contenido de la celda.
Método protegido OnContentDoubleClick Se le llama al hacer doble clic en el contenido de la celda.
Método protegido OnDataGridViewChanged Se le llama cuando cambia la propiedad DataGridView de la celda. (Invalida a DataGridViewElement.OnDataGridViewChanged).
Método protegido OnDoubleClick Se le llama al hacer doble clic en la celda.
Método protegido OnEnter Se le llama cuando el foco se desplaza a una celda.
Método protegido OnKeyDown Se le llama cuando se presiona una tecla de carácter mientras el foco está en una celda.
Método protegido OnKeyPress Se le llama cuando se presiona una tecla mientras el foco está en una celda.
Método protegido OnKeyUp Se le llama cuando se suelta una tecla de carácter mientras el foco está en una celda.
Método protegido OnLeave Se le llama cuando el foco se desplaza de una celda.
Método protegido OnMouseClick Se le llama cuando el usuario hace clic en un botón del mouse mientras el puntero está en una celda.
Método protegido OnMouseDoubleClick Se le llama cuando el usuario hace clic en un botón del mouse mientras el puntero está en una celda.
Método protegido OnMouseDown Se le llama cuando el usuario mantiene presionado un botón del mouse mientras el puntero está en una celda.
Método protegido OnMouseEnter Se le llama cuando el puntero del mouse se mueve sobre una celda.
Método protegido OnMouseLeave Se le llama cuando el puntero del mouse sale de la celda.
Método protegido OnMouseMove Se le llama cuando el puntero del mouse se mueve dentro de una celda.
Método protegido OnMouseUp Se le llama cuando el usuario suelta un botón del mouse mientras el puntero está en una celda.
Método protegido Paint Dibuja la celda DataGridViewCell actual.
Método protegido PaintBorder Dibuja el borde del control DataGridViewCell actual.
Método protegido PaintErrorIcon Dibuja el icono de error del control DataGridViewCell actual.
Método público ParseFormattedValue Convierte un valor con formato de presentación en un valor de celda real.
Método público PositionEditingControl Establece la ubicación y tamaño del control de edición que hospeda una celda del control DataGridView.
Método público PositionEditingPanel Establece la ubicación y tamaño del panel de edición que hospeda la celda y devuelve los límites normales del control de edición dentro del panel de edición.
Método protegido RaiseCellClick Provoca el evento DataGridView.CellClick. (Se hereda de DataGridViewElement).
Método protegido RaiseCellContentClick Genera el evento DataGridView.CellContentClick. (Se hereda de DataGridViewElement).
Método protegido RaiseCellContentDoubleClick Genera el evento DataGridView.CellContentDoubleClick. (Se hereda de DataGridViewElement).
Método protegido RaiseCellValueChanged Genera el evento DataGridView.CellValueChanged. (Se hereda de DataGridViewElement).
Método protegido RaiseDataError Genera el evento DataGridView.DataError. (Se hereda de DataGridViewElement).
Método protegido RaiseMouseWheel Provoca el evento Control.MouseWheel. (Se hereda de DataGridViewElement).
Método protegido SetValue Establece el valor de la celda.
Método público ToString Devuelve una cadena que describe el objeto actual. (Invalida a Object.ToString).
Arriba

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

La fila y la columna de DataGridViewCell identifican la ubicación de la celda en el control DataGridView. Una celda normal contiene los datos específicos de la fila y la columna que la contienen. La celda se puede personalizar de varias maneras estableciendo sus propiedades y controlando los eventos asociados a ella.

Notas para los herederos

Cuando derive de DataGridViewCell 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 la clase base se copien en la nueva celda.

En el ejemplo de código siguiente se muestra el uso de este tipo. Para obtener más información sobre este elemento, vea Cómo: Agregar información sobre herramientas a celdas individuales en un control DataGridView de formularios Windows Forms.

C#
C++
VB
Copiar 

// 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";
        }
    }
}

.NET Framework

Compatible con: 4, 3.5, 3.0, 2.0

.NET Framework Client Profile

Compatible con: 4, 3.5 SP1

Windows 7, Windows Vista SP1 o posterior, Windows XP SP3, Windows XP SP2 x64 Edition, Windows Server 2008 (no se admite Server Core), Windows Server 2008 R2 (se admite Server Core con SP1 o posterior), Windows Server 2003 SP2

.NET Framework no admite todas las versiones de todas las plataformas. Para obtener una lista de las versiones compatibles, vea Requisitos de sistema de .NET Framework.
Todos los miembros static (Shared en Visual Basic) públicos 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.
¿Te ha resultado útil?
(Caracteres restantes: 2000)
Contenido de la comunidad Agregar
Anotaciones Preguntas más frecuentes