DataGridViewTextBoxCell Classe

Definição

Namespace:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Origem:

DataGridViewTextBoxCell.cs

Exibe informações de texto editável em um controle DataGridView.

public ref class DataGridViewTextBoxCell : System::Windows::Forms::DataGridViewCell

public class DataGridViewTextBoxCell : System.Windows.Forms.DataGridViewCell

type DataGridViewTextBoxCell = class
    inherit DataGridViewCell

Public Class DataGridViewTextBoxCell
Inherits DataGridViewCell

Herança

Object

DataGridViewElement

DataGridViewCell

DataGridViewTextBoxCell

Exemplos

O exemplo de código a seguir demonstra como usar um DataGridViewCell como modelo para um DataGridViewColumn. As alterações de estilo feitas em qualquer célula na coluna afetam todas as células da coluna. Este exemplo de código faz parte de um exemplo maior fornecido para a DataGridViewColumn classe .

void CustomizeCellsInThirdColumn()
{
   int thirdColumn = 2;
   DataGridViewColumn^ column = dataGridView->Columns[ thirdColumn ];
   DataGridViewCell^ cell = gcnew DataGridViewTextBoxCell;
   cell->Style->BackColor = Color::Wheat;
   column->CellTemplate = cell;
}

private void CustomizeCellsInThirdColumn()
{
    int thirdColumn = 2;
    DataGridViewColumn column =
        dataGridView.Columns[thirdColumn];
    DataGridViewCell cell = new DataGridViewTextBoxCell();

    cell.Style.BackColor = Color.Wheat;
    column.CellTemplate = cell;
}

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

Comentários

A DataGridViewTextBoxCell classe é um tipo especializado de DataGridViewCell usado para exibir uma única cadeia de caracteres de informações editáveis baseadas em texto. O selecionado DataGridViewTextBoxCell atualmente hospeda um DataGridViewTextBoxEditingControl controle no qual o usuário pode editar o valor da célula (supondo que a ReadOnly propriedade do DataGridViewTextBoxCell esteja definida como false).

O DataGridViewTextBoxColumn é o tipo de coluna especializado para armazenar células desse tipo. Por padrão, o DataGridViewTextBoxColumn.CellTemplate é inicializado para um novo DataGridViewTextBoxCell. Para padronizar as células dentro de uma coluna após um existente DataGridViewTextBoxCell, defina a propriedade da CellTemplate coluna como a célula a ser usada como um padrão.

As propriedades relacionadas à célula da coluna são wrappers para as propriedades de nome semelhante da célula de modelo. A alteração dos valores de propriedade da célula de modelo afetará apenas as células com base no modelo adicionado após a alteração. No entanto, alterar os valores da propriedade relacionada à célula da coluna atualizará a célula de modelo e todas as outras células da coluna e atualizará a exibição da coluna, se necessário.

Notas aos Herdeiros

Ao derivar de DataGridViewTextBoxCell e adicionar novas propriedades à classe derivada, substitua o Clone() método para copiar as novas propriedades durante as operações de clonagem. Você também deve chamar o método da Clone() classe base para que as propriedades da classe base sejam copiadas para a nova célula.

Construtores

DataGridViewTextBoxCell()

Inicializa uma nova instância da classe DataGridViewTextBoxCell.

Propriedades

AccessibilityObject	Obtém o DataGridViewCell.DataGridViewCellAccessibleObject atribuído ao DataGridViewCell. (Herdado de DataGridViewCell)
ColumnIndex	Obtém o índice da coluna para essa célula. (Herdado de DataGridViewCell)
ContentBounds	Obtém o retângulo delimitador que circunscreve a área de conteúdo da célula. (Herdado de DataGridViewCell)
ContextMenuStrip	Obtém ou define o menu de atalho associado à célula. (Herdado de DataGridViewCell)
DataGridView	Obtém o controle de DataGridView associado a esse elemento. (Herdado de DataGridViewElement)
DefaultNewRowValue	Obtém o valor padrão para uma célula na linha para novos registros. (Herdado de DataGridViewCell)
Displayed	Obtém um valor que indica se a célula é exibida na tela no momento. (Herdado de DataGridViewCell)
EditedFormattedValue	Obtém o valor atual, formatado da célula, independentemente se a célula estiver em modo de edição e o valor não tiver sido confirmado. (Herdado de DataGridViewCell)
EditType	Obtém o tipo de controle de edição hospedado da célula. (Herdado de DataGridViewCell)
ErrorIconBounds	Obtém os limites do ícone de erro para a célula. (Herdado de DataGridViewCell)
ErrorText	Obtém ou define o texto que descreve uma condição de erro associada à célula. (Herdado de DataGridViewCell)
FormattedValue	Obtém o valor da célula como formatado para exibição. (Herdado de DataGridViewCell)
FormattedValueType	Obtém o tipo do valor formatado associado à célula.
Frozen	Obtém um valor que indica se a célula está congelada. (Herdado de DataGridViewCell)
HasStyle	Obtém um valor que indica se a propriedade Style foi definida. (Herdado de DataGridViewCell)
InheritedState	Obtém o estado atual da célula conforme herdado do estado de sua linha e coluna. (Herdado de DataGridViewCell)
InheritedStyle	Obtém o estilo atualmente aplicado à célula. (Herdado de DataGridViewCell)
IsInEditMode	Obtém um valor que indica se esta célula está sendo editada no momento. (Herdado de DataGridViewCell)
MaxInputLength	Obtém ou define o número máximo de caracteres que podem ser inseridos na caixa de texto.
OwningColumn	Obtém a coluna que contém essa célula. (Herdado de DataGridViewCell)
OwningRow	Obtém a linha que contém essa célula. (Herdado de DataGridViewCell)
PreferredSize	Obtém o tamanho, em pixels, de uma área retangular na qual o controle pode caber. (Herdado de DataGridViewCell)
ReadOnly	Obtém ou define um valor que indica se os dados da célula podem ser editados. (Herdado de DataGridViewCell)
Resizable	Obtém um valor que indica se a célula pode ser redimensionada. (Herdado de DataGridViewCell)
RowIndex	Obtém o índice da linha pai da célula. (Herdado de DataGridViewCell)
Selected	Obtém ou define um valor que indica se a célula foi selecionada. (Herdado de DataGridViewCell)
Size	Obtém o tamanho da célula. (Herdado de DataGridViewCell)
State	Obtém o estado da UI (interface do usuário) do elemento. (Herdado de DataGridViewElement)
Style	Obtém ou define o estilo da célula. (Herdado de DataGridViewCell)
Tag	Obtém ou define o objeto que contém dados complementares sobre a célula. (Herdado de DataGridViewCell)
ToolTipText	Obtém ou define o texto de ToolTip associado à célula. (Herdado de DataGridViewCell)
Value	Obtém ou define o valor associado a esta célula. (Herdado de DataGridViewCell)
ValueType	Obtém ou define o tipo de dados dos valores na célula.
Visible	Obtém um valor que indica se a célula está em uma linha ou coluna ocultada. (Herdado de DataGridViewCell)

Métodos

AdjustCellBorderStyle(DataGridViewAdvancedBorderStyle, DataGridViewAdvancedBorderStyle, Boolean, Boolean, Boolean, Boolean)	Modifica o estilo de borda da célula de entrada de acordo com os critérios especificados. (Herdado de DataGridViewCell)
BorderWidths(DataGridViewAdvancedBorderStyle)	Retorna um Rectangle que representa a largura de todas as margens da célula. (Herdado de DataGridViewCell)
ClickUnsharesRow(DataGridViewCellEventArgs)	Indica se linha da célula será descompartilhada quando a célula é clicada. (Herdado de DataGridViewCell)
Clone()	Cria uma cópia exata desta célula.
ContentClickUnsharesRow(DataGridViewCellEventArgs)	Indica se linha da célula será descompartilhada quando o conteúdo da célula é clicado. (Herdado de DataGridViewCell)
ContentDoubleClickUnsharesRow(DataGridViewCellEventArgs)	Indica se linha da célula será descompartilhada quando o conteúdo da célula é clicado duas vezes. (Herdado de DataGridViewCell)
CreateAccessibilityInstance()	Cria um novo AccessibleObject para essa instância DataGridViewTextBoxCell.
DetachEditingControl()	Remove o controle de edição da célula do DataGridView.
Dispose()	Libera todos os recursos usados pelo DataGridViewCell. (Herdado de DataGridViewCell)
Dispose(Boolean)	Libera os recursos não gerenciados usados pelo DataGridViewCell e opcionalmente libera os recursos gerenciados. (Herdado de DataGridViewCell)
DoubleClickUnsharesRow(DataGridViewCellEventArgs)	Indica se linha da célula será descompartilhada quando a célula é clicada duas vezes. (Herdado de DataGridViewCell)
EnterUnsharesRow(Int32, Boolean)	Indica se a linha pai será descompartilhada quando o foto se move para a célula. (Herdado de DataGridViewCell)
Equals(Object)	Determina se o objeto especificado é igual ao objeto atual. (Herdado de Object)
GetClipboardContent(Int32, Boolean, Boolean, Boolean, Boolean, String)	Recupera o valor formatado da célula a ser copiado para o Clipboard. (Herdado de DataGridViewCell)
GetContentBounds(Graphics, DataGridViewCellStyle, Int32)	Retorna o retângulo delimitador que inclui a área de conteúdo da célula, que é calculada usando o Graphics e o estilo da célula especificados.
GetContentBounds(Int32)	Retorna o retângulo delimitador que circunscreve a área de conteúdo da célula usando um estilo de Graphics e célula padrão em vigor atualmente para a célula. (Herdado de DataGridViewCell)
GetEditedFormattedValue(Int32, DataGridViewDataErrorContexts)	Retorna o valor atual formatado da célula, independentemente de se a célula está em modo de edição e o valor não foi confirmado. (Herdado de DataGridViewCell)
GetErrorIconBounds(Graphics, DataGridViewCellStyle, Int32)	Retorna o retângulo delimitador que inclui o ícone de erro da célula, se exibido.
GetErrorText(Int32)	Retorna uma cadeia de caracteres que representa o erro da célula. (Herdado de DataGridViewCell)
GetFormattedValue(Object, Int32, DataGridViewCellStyle, TypeConverter, TypeConverter, DataGridViewDataErrorContexts)	Obtém o valor da célula como formatado para exibição. (Herdado de DataGridViewCell)
GetHashCode()	Serve como a função de hash padrão. (Herdado de Object)
GetInheritedContextMenuStrip(Int32)	Obtém o menu de atalho herdado para a célula atual. (Herdado de DataGridViewCell)
GetInheritedState(Int32)	Retorna um valor que indica o estado atual da célula conforme herdado do estado da própria linha e coluna. (Herdado de DataGridViewCell)
GetInheritedStyle(DataGridViewCellStyle, Int32, Boolean)	Obtém o estilo aplicado à célula. (Herdado de DataGridViewCell)
GetPreferredSize(Graphics, DataGridViewCellStyle, Int32, Size)	Calcula o tamanho preferido da célula em pixels.
GetSize(Int32)	Obtém o tamanho da célula. (Herdado de DataGridViewCell)
GetType()	Obtém o Type da instância atual. (Herdado de Object)
GetValue(Int32)	Obtém o valor da célula. (Herdado de DataGridViewCell)
InitializeEditingControl(Int32, Object, DataGridViewCellStyle)	Anexa e inicializa o controle de edição hospedado.
KeyDownUnsharesRow(KeyEventArgs, Int32)	Indica se a linha pai é descompartilhada se o usuário pressionar uma tecla enquanto o foco está na célula. (Herdado de DataGridViewCell)
KeyEntersEditMode(KeyEventArgs)	Determina se o modo de edição deve ser iniciado com base na chave especificada.
KeyPressUnsharesRow(KeyPressEventArgs, Int32)	Indica se uma linha será descompartilhada se uma tecla for pressionada enquanto uma célula na linha tem o foco. (Herdado de DataGridViewCell)
KeyUpUnsharesRow(KeyEventArgs, Int32)	Indica se a linha pai é descompartilhada quando o usuário libera uma tecla enquanto o foco está na célula. (Herdado de DataGridViewCell)
LeaveUnsharesRow(Int32, Boolean)	Indica se uma linha será descompartilhada quando o foco sair de uma célula na linha. (Herdado de DataGridViewCell)
MemberwiseClone()	Cria uma cópia superficial do Object atual. (Herdado de Object)
MouseClickUnsharesRow(DataGridViewCellMouseEventArgs)	Indica se uma linha será descompartilhada se o usuário clicar em um botão do mouse enquanto o ponteiro está em uma célula na linha. (Herdado de DataGridViewCell)
MouseDoubleClickUnsharesRow(DataGridViewCellMouseEventArgs)	Indica se uma linha será descompartilhada se o usuário clicar duas vezes em uma célula na linha. (Herdado de DataGridViewCell)
MouseDownUnsharesRow(DataGridViewCellMouseEventArgs)	Indica se uma linha será descompartilhada quando o usuário manter pressionado um botão do mouse enquanto o ponteiro está em uma célula na linha. (Herdado de DataGridViewCell)
MouseEnterUnsharesRow(Int32)	Indica se uma linha será descompartilhada quando o ponteiro do mouse passar sobre uma célula na linha. (Herdado de DataGridViewCell)
MouseLeaveUnsharesRow(Int32)	Indica se uma linha será descompartilhada quando o ponteiro do mouse sair da linha. (Herdado de DataGridViewCell)
MouseMoveUnsharesRow(DataGridViewCellMouseEventArgs)	Indica se uma linha será descompartilhada quando o ponteiro do mouse passar sobre uma célula na linha. (Herdado de DataGridViewCell)
MouseUpUnsharesRow(DataGridViewCellMouseEventArgs)	Indica se uma linha será descompartilhada quando o usuário liberar um botão do mouse enquanto o ponteiro está em uma célula na linha. (Herdado de DataGridViewCell)
OnClick(DataGridViewCellEventArgs)	Chamado quando se clica na célula. (Herdado de DataGridViewCell)
OnContentClick(DataGridViewCellEventArgs)	Chamado quando ocorre um clique no conteúdo da célula. (Herdado de DataGridViewCell)
OnContentDoubleClick(DataGridViewCellEventArgs)	Chamado quando ocorre um clique duplo no conteúdo da célula. (Herdado de DataGridViewCell)
OnDataGridViewChanged()	Chamado quando a propriedade DataGridView da célula é alterada. (Herdado de DataGridViewCell)
OnDoubleClick(DataGridViewCellEventArgs)	Chamado quando ocorre um clique duplo na célula. (Herdado de DataGridViewCell)
OnEnter(Int32, Boolean)	Chamado por DataGridView quando o cursor de seleção é movido para uma célula.
OnKeyDown(KeyEventArgs, Int32)	Chamado quando uma tecla de caractere é pressionada enquanto o foco está em uma célula. (Herdado de DataGridViewCell)
OnKeyPress(KeyPressEventArgs, Int32)	Chamado quando uma tecla é pressionada enquanto o foco está em uma célula. (Herdado de DataGridViewCell)
OnKeyUp(KeyEventArgs, Int32)	Chamado quando uma tecla de caractere é liberada enquanto o foco está em uma célula. (Herdado de DataGridViewCell)
OnLeave(Int32, Boolean)	Chamado pelo DataGridView quando o mouse deixa uma célula.
OnMouseClick(DataGridViewCellMouseEventArgs)	Chamado por DataGridView quando o mouse deixa uma célula.
OnMouseDoubleClick(DataGridViewCellMouseEventArgs)	Chamado quando o usuário clica duas vezes em um botão do mouse enquanto o ponteiro está em uma célula. (Herdado de DataGridViewCell)
OnMouseDown(DataGridViewCellMouseEventArgs)	Chamado quando o usuário mantém o botão do mouse pressionado enquanto o ponteiro está em uma célula. (Herdado de DataGridViewCell)
OnMouseEnter(Int32)	Chamado quando o ponteiro do mouse se move sobre uma célula. (Herdado de DataGridViewCell)
OnMouseLeave(Int32)	Chamado quando o ponteiro do mouse deixa a célula. (Herdado de DataGridViewCell)
OnMouseMove(DataGridViewCellMouseEventArgs)	Chamado quando o ponteiro do mouse se move dentro de uma célula. (Herdado de DataGridViewCell)
OnMouseUp(DataGridViewCellMouseEventArgs)	Chamado quando o usuário solta o botão do mouse enquanto o ponteiro está em uma célula. (Herdado de DataGridViewCell)
Paint(Graphics, Rectangle, Rectangle, Int32, DataGridViewElementStates, Object, Object, String, DataGridViewCellStyle, DataGridViewAdvancedBorderStyle, DataGridViewPaintParts)	Pinta o DataGridViewCell atual.
PaintBorder(Graphics, Rectangle, Rectangle, DataGridViewCellStyle, DataGridViewAdvancedBorderStyle)	Pinta a borda do DataGridViewCell atual. (Herdado de DataGridViewCell)
PaintErrorIcon(Graphics, Rectangle, Rectangle, String)	Pinta o ícone de erro do DataGridViewCell atual. (Herdado de DataGridViewCell)
ParseFormattedValue(Object, DataGridViewCellStyle, TypeConverter, TypeConverter)	Converte um valor formatado para exibição no valor real da célula. (Herdado de DataGridViewCell)
PositionEditingControl(Boolean, Boolean, Rectangle, Rectangle, DataGridViewCellStyle, Boolean, Boolean, Boolean, Boolean)	Define o local e o tamanho do controle edição hospedado por uma célula no controle DataGridView.
PositionEditingPanel(Rectangle, Rectangle, DataGridViewCellStyle, Boolean, Boolean, Boolean, Boolean)	Define o local e o tamanho do painel de edição hospedado pela célula e retorna os limites normais do controle de edição dentro do painel de edição. (Herdado de DataGridViewCell)
RaiseCellClick(DataGridViewCellEventArgs)	Aciona o evento CellClick. (Herdado de DataGridViewElement)
RaiseCellContentClick(DataGridViewCellEventArgs)	Aciona o evento CellContentClick. (Herdado de DataGridViewElement)
RaiseCellContentDoubleClick(DataGridViewCellEventArgs)	Aciona o evento CellContentDoubleClick. (Herdado de DataGridViewElement)
RaiseCellValueChanged(DataGridViewCellEventArgs)	Aciona o evento CellValueChanged. (Herdado de DataGridViewElement)
RaiseDataError(DataGridViewDataErrorEventArgs)	Aciona o evento DataError. (Herdado de DataGridViewElement)
RaiseMouseWheel(MouseEventArgs)	Aciona o evento MouseWheel. (Herdado de DataGridViewElement)
SetValue(Int32, Object)	Define o valor da célula. (Herdado de DataGridViewCell)
ToString()	Retorna uma cadeia de caracteres que descreve o objeto atual.

Confira também

• DataGridView
• DataGridViewCell
• DataGridViewTextBoxColumn
• CellTemplate
• DataGridViewTextBoxEditingControl