Evaluar y enviar comentarios
Contraer todo/Expandir todo Contraer todo
Esta página es específica de
Microsoft Visual Studio 2008/.NET Framework 3.5

Hay además otras versiones disponibles para:
Biblioteca de clases de .NET Framework
DataGridViewTextBoxCell (Clase)

Actualización: noviembre 2007

Muestra información de texto modificable en un control DataGridView.

Espacio de nombres:  System.Windows.Forms
Ensamblado:  System.Windows.Forms (en System.Windows.Forms.dll)
Visual Basic (Declaración)
Public Class DataGridViewTextBoxCell _
    Inherits DataGridViewCell
Visual Basic (Uso)
Dim instance As DataGridViewTextBoxCell
C#
public class DataGridViewTextBoxCell : DataGridViewCell
Visual C++
public ref class DataGridViewTextBoxCell : public DataGridViewCell
J#
public class DataGridViewTextBoxCell extends DataGridViewCell
JScript
public class DataGridViewTextBoxCell extends DataGridViewCell

La clase DataGridViewTextBoxCell es un tipo especializado de DataGridViewCell utilizado para mostrar una única cadena de información basada en texto modificable. La celda DataGridViewTextBoxCell actualmente seleccionado aloja un control DataGridViewTextBoxEditingControl en el que el usuario puede editar el valor de la celda (suponiendo que la propiedad ReadOnly de DataGridViewTextBoxCell está establecida en false).

DataGridViewTextBoxColumn corresponde al tipo de columna especializado para contener celdas de este tipo. Para modelar las celdas dentro de una columna como un control DataGridViewTextBoxCell existente, establezca la propiedad CellTemplate de la columna en esa celda. De manera predeterminada, la plantilla CellTemplate se inicializa con una nueva instancia de DataGridViewTextBoxCell.

Las propiedades de la columna relacionadas con celdas actúan como contenedores para las propiedades con similar denominación de la celda de plantilla. Al cambiar los valores de propiedad de la celda de plantilla sólo se verán afectadas las celdas que estén basadas en la plantilla y se hayan agregado después del cambio. Al cambiar los valores de propiedad relacionados con las celdas de la columna, sin embargo, se actualizará la celda de la plantilla y también todas las demás celdas de la columna, actualizando su presentación si es necesario.

Notas para los herederos:

Cuando derive del control DataGridViewTextBoxCell 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 a la nueva celda.

En el ejemplo de código siguiente se muestra cómo utilizar DataGridViewCell como una plantilla para DataGridViewColumn. Los cambios de estilo realizados en cualquier celda de la columna afectan a todas las celdas de la columna. Este ejemplo de código forma parte de un ejemplo más extenso referente a la clase DataGridViewColumn.

Visual Basic
Private Sub CustomizeCellsInThirdColumn()

    Dim thirdColumn As Integer = 2
    Dim column As DataGridViewColumn = _
        dataGridView.Columns(thirdColumn)
    Dim cell As DataGridViewCell = _
        New DataGridViewTextBoxCell()

    cell.Style.BackColor = Color.Wheat
    column.CellTemplate = cell
End Sub
C#
private void CustomizeCellsInThirdColumn()
{
    int thirdColumn = 2;
    DataGridViewColumn column =
        dataGridView.Columns[thirdColumn];
    DataGridViewCell cell = new DataGridViewTextBoxCell();

    cell.Style.BackColor = Color.Wheat;
    column.CellTemplate = cell;
}
System..::.Object
  System.Windows.Forms..::.DataGridViewElement
    System.Windows.Forms..::.DataGridViewCell
      System.Windows.Forms..::.DataGridViewTextBoxCell
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.

Windows Vista, Windows XP SP2, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP Starter Edition, Windows Server 2003, Windows Server 2000 SP4, Windows Millennium Edition, Windows 98

.NET Framework y .NET Compact Framework no admiten todas las versiones de cada plataforma. Para obtener una lista de las versiones compatibles, vea Requisitos de sistema de .NET Framework.

.NET Framework

Compatible con: 3.5, 3.0, 2.0
Contenido de la comunidad   ¿Qué es Community Content?
Agregar contenido nuevo RSS  Anotaciones
Processing
© 2012 Microsoft. Reservados todos los derechos. Términos de uso | Marcas Registradas | Privacidad
Page view tracker