DataGridViewCell Classe
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Representa uma célula individual em um controle 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- Herança
- Derivado
- Atributos
- Implementações
O exemplo de código a seguir ilustra o uso desse tipo. Para obter mais informações sobre este exemplo, consulte 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
A DataGridViewCell classe representa uma célula individual em um DataGridView controle . Você pode recuperar células por meio da Cells coleção de um DataGridViewRow.
A linha e a coluna de um DataGridViewCell identificam o local da célula no DataGridView. Uma célula típica contém dados específicos para a linha e a coluna na qual ela está contida. A célula pode ser personalizada de várias maneiras definindo suas propriedades e manipulando os eventos associados a ela.
Ao derivar de DataGridViewCell 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.
|
Data |
Inicializa uma nova instância da classe DataGridViewCell. |
|
Accessibility |
Obtém o DataGridViewCell.DataGridViewCellAccessibleObject atribuído ao DataGridViewCell. |
|
Column |
Obtém o índice da coluna para essa célula. |
|
Content |
Obtém o retângulo delimitador que circunscreve a área de conteúdo da célula. |
|
Context |
Obtém ou define o menu de atalho associado à célula. |
|
Data |
Obtém o controle de DataGridView associado a esse elemento. (Herdado de DataGridViewElement) |
|
Default |
Obtém o valor padrão para uma célula na linha para novos registros. |
| Displayed |
Obtém um valor que indica se a célula é exibida na tela no momento. |
|
Edited |
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. |
|
Edit |
Obtém o tipo de controle de edição hospedado da célula. |
|
Error |
Obtém os limites do ícone de erro para a célula. |
|
Error |
Obtém ou define o texto que descreve uma condição de erro associada à célula. |
|
Formatted |
Obtém o valor da célula como formatado para exibição. |
|
Formatted |
Obtém o tipo do valor formatado associado à célula. |
| Frozen |
Obtém um valor que indica se a célula está congelada. |
|
Has |
Obtém um valor que indica se a propriedade Style foi definida. |
|
Inherited |
Obtém o estado atual da célula conforme herdado do estado de sua linha e coluna. |
|
Inherited |
Obtém o estilo atualmente aplicado à célula. |
|
Is |
Obtém um valor que indica se esta célula está sendo editada no momento. |
|
Owning |
Obtém a coluna que contém essa célula. |
|
Owning |
Obtém a linha que contém essa célula. |
|
Preferred |
Obtém o tamanho, em pixels, de uma área retangular na qual o controle pode caber. |
|
Read |
Obtém ou define um valor que indica se os dados da célula podem ser editados. |
| Resizable |
Obtém um valor que indica se a célula pode ser redimensionada. |
|
Row |
Obtém o índice da linha pai da célula. |
| Selected |
Obtém ou define um valor que indica se a célula foi selecionada. |
| Size |
Obtém o tamanho da célula. |
| 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. |
| Tag |
Obtém ou define o objeto que contém dados complementares sobre a célula. |
|
Tool |
Obtém ou define o texto de ToolTip associado à célula. |
| Value |
Obtém ou define o valor associado a esta célula. |
|
Value |
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. |
|
Adjust |
Modifica o estilo de borda da célula de entrada de acordo com os critérios especificados. |
|
Border |
Retorna um Rectangle que representa a largura de todas as margens da célula. |
|
Click |
Indica se linha da célula será descompartilhada quando a célula é clicada. |
| Clone() |
Cria uma cópia exata desta célula. |
|
Content |
Indica se linha da célula será descompartilhada quando o conteúdo da célula é clicado. |
|
Content |
Indica se linha da célula será descompartilhada quando o conteúdo da célula é clicado duas vezes. |
|
Create |
Cria um novo objeto acessível para o DataGridViewCell. |
|
Detach |
Remove o controle de edição da célula do DataGridView. |
| Dispose() |
Libera todos os recursos usados pelo DataGridViewCell. |
| Dispose(Boolean) |
Libera os recursos não gerenciados usados pelo DataGridViewCell e opcionalmente libera os recursos gerenciados. |
|
Double |
Indica se linha da célula será descompartilhada quando a célula é clicada duas vezes. |
|
Enter |
Indica se a linha pai será descompartilhada quando o foto se move para a célula. |
| Equals(Object) |
Determina se o objeto especificado é igual ao objeto atual. (Herdado de Object) |
| Finalize() |
Libera os recursos não gerenciados e executa outras operações de limpeza antes que DataGridViewCell seja recuperado pela coleta de lixo. |
|
Get |
Recupera o valor formatado da célula a ser copiado para o Clipboard. |
|
Get |
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. |
|
Get |
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. |
|
Get |
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. |
|
Get |
Retorna o retângulo delimitador que inclui o ícone de erro da célula, se exibido. |
|
Get |
Retorna uma cadeia de caracteres que representa o erro da célula. |
|
Get |
Obtém o valor da célula como formatado para exibição. |
|
Get |
Serve como a função de hash padrão. (Herdado de Object) |
|
Get |
Obtém o menu de atalho herdado para a célula atual. |
|
Get |
Retorna um valor que indica o estado atual da célula conforme herdado do estado da própria linha e coluna. |
|
Get |
Obtém o estilo aplicado à célula. |
|
Get |
Calcula o tamanho preferido da célula em pixels. |
|
Get |
Obtém o tamanho da célula. |
|
Get |
Obtém o Type da instância atual. (Herdado de Object) |
|
Get |
Obtém o valor da célula. |
|
Initialize |
Inicializa o controle usado para editar a célula. |
|
Key |
Indica se a linha pai é descompartilhada se o usuário pressionar uma tecla enquanto o foco está na célula. |
|
Key |
Determina se o modo de edição deve ser iniciado com base na chave especificada. |
|
Key |
Indica se uma linha será descompartilhada se uma tecla for pressionada enquanto uma célula na linha tem o foco. |
|
Key |
Indica se a linha pai é descompartilhada quando o usuário libera uma tecla enquanto o foco está na célula. |
|
Leave |
Indica se uma linha será descompartilhada quando o foco sair de uma célula na linha. |
|
Measure |
Obtém a altura, em pixels, do texto especificado, dadas as características indicadas. |
|
Measure |
Obtém a altura, em pixels, do texto especificado, dadas as características indicadas. Também indica se a largura necessária é maior que a largura máxima especificada. |
|
Measure |
Obtém a altura e a largura ideal do texto especificado, dadas as características indicadas. |
|
Measure |
Obtém a altura e a largura do texto especificado, dadas as características indicadas. |
|
Measure |
Obtém a largura, em pixels, do texto especificado, dadas as características indicadas. |
|
Memberwise |
Cria uma cópia superficial do Object atual. (Herdado de Object) |
|
Mouse |
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. |
|
Mouse |
Indica se uma linha será descompartilhada se o usuário clicar duas vezes em uma célula na linha. |
|
Mouse |
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. |
|
Mouse |
Indica se uma linha será descompartilhada quando o ponteiro do mouse passar sobre uma célula na linha. |
|
Mouse |
Indica se uma linha será descompartilhada quando o ponteiro do mouse sair da linha. |
|
Mouse |
Indica se uma linha será descompartilhada quando o ponteiro do mouse passar sobre uma célula na linha. |
|
Mouse |
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. |
|
On |
Chamado quando se clica na célula. |
|
On |
Chamado quando ocorre um clique no conteúdo da célula. |
|
On |
Chamado quando ocorre um clique duplo no conteúdo da célula. |
|
On |
Chamado quando a propriedade DataGridView da célula é alterada. |
|
On |
Chamado quando ocorre um clique duplo na célula. |
|
On |
Chamado quando o foco chega a uma célula. |
|
On |
Chamado quando uma tecla de caractere é pressionada enquanto o foco está em uma célula. |
|
On |
Chamado quando uma tecla é pressionada enquanto o foco está em uma célula. |
|
On |
Chamado quando uma tecla de caractere é liberada enquanto o foco está em uma célula. |
|
On |
Chamado quando o foco sai de uma célula. |
|
On |
Chamado quando o usuário clica em um botão do mouse enquanto o ponteiro está em uma célula. |
|
On |
Chamado quando o usuário clica duas vezes em um botão do mouse enquanto o ponteiro está em uma célula. |
|
On |
Chamado quando o usuário mantém o botão do mouse pressionado enquanto o ponteiro está em uma célula. |
|
On |
Chamado quando o ponteiro do mouse se move sobre uma célula. |
|
On |
Chamado quando o ponteiro do mouse deixa a célula. |
|
On |
Chamado quando o ponteiro do mouse se move dentro de uma célula. |
|
On |
Chamado quando o usuário solta o botão do mouse enquanto o ponteiro está em uma célula. |
|
Paint(Graphics, Rectangle, Rectangle, Int32, Data |
Pinta o DataGridViewCell atual. |
|
Paint |
Pinta a borda do DataGridViewCell atual. |
|
Paint |
Pinta o ícone de erro do DataGridViewCell atual. |
|
Parse |
Converte um valor formatado para exibição no valor real da célula. |
|
Position |
Define o local e o tamanho do controle de edição hospedado por uma célula no controle DataGridView. |
|
Position |
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. |
|
Raise |
Aciona o evento CellClick. (Herdado de DataGridViewElement) |
|
Raise |
Aciona o evento CellContentClick. (Herdado de DataGridViewElement) |
|
Raise |
Aciona o evento CellContentDoubleClick. (Herdado de DataGridViewElement) |
|
Raise |
Aciona o evento CellValueChanged. (Herdado de DataGridViewElement) |
|
Raise |
Aciona o evento DataError. (Herdado de DataGridViewElement) |
|
Raise |
Aciona o evento MouseWheel. (Herdado de DataGridViewElement) |
|
Set |
Define o valor da célula. |
|
To |
Retorna uma cadeia de caracteres que descreve o objeto atual. |
| Produto | Versões |
|---|---|
| .NET Framework | 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1 |
| Windows Desktop | 3.0, 3.1, 5, 6, 7, 8, 9 |
Comentários do .NET
O .NET é um projeto código aberto. Selecione um link para fornecer comentários: