Actualización: noviembre 2007
Muestra información de texto modificable en un control DataGridView.
Public Class DataGridViewTextBoxCell _ Inherits DataGridViewCell
Dim instance As DataGridViewTextBoxCell
public class DataGridViewTextBoxCell : DataGridViewCell
public ref class DataGridViewTextBoxCell : public DataGridViewCell
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.
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.
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
private void CustomizeCellsInThirdColumn() { int thirdColumn = 2; DataGridViewColumn column = dataGridView.Columns[thirdColumn]; DataGridViewCell cell = new DataGridViewTextBoxCell(); cell.Style.BackColor = Color.Wheat; column.CellTemplate = cell; }
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