DataGridViewCell Classe

  • Referência

Definição

Namespace:
System.Windows.Forms
Assembly:
System.Windows.Forms.dll

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 IDisposable
Public MustInherit Class DataGridViewCell
Inherits DataGridViewElement
Implements ICloneable, IDisposable
Herança
Object
DataGridViewElement
DataGridViewCell
Derivado
Atributos
TypeConverterAttribute
Implementações
ICloneable IDisposable

Exemplos

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

Comentários

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.

Notas aos Implementadores

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.

Construtores

DataGridViewCell()

Inicializa uma nova instância da classe DataGridViewCell.

Propriedades

AccessibilityObject

Obtém o DataGridViewCell.DataGridViewCellAccessibleObject atribuído ao DataGridViewCell.
ColumnIndex

Obtém o índice da coluna para essa célula.
ContentBounds

Obtém o retângulo delimitador que circunscreve a área de conteúdo da célula.
ContextMenuStrip

Obtém ou define o menu de atalho associado à célula.
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.
Displayed

Obtém um valor que indica se a célula é exibida na tela no momento.
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.
EditType

Obtém o tipo de controle de edição hospedado da célula.
ErrorIconBounds

Obtém os limites do ícone de erro para a célula.
ErrorText

Obtém ou define o texto que descreve uma condição de erro associada à célula.
FormattedValue

Obtém o valor da célula como formatado para exibição.
FormattedValueType

Obtém o tipo do valor formatado associado à célula.
Frozen

Obtém um valor que indica se a célula está congelada.
HasStyle

Obtém um valor que indica se a propriedade Style foi definida.
InheritedState

Obtém o estado atual da célula conforme herdado do estado de sua linha e coluna.
InheritedStyle

Obtém o estilo atualmente aplicado à célula.
IsInEditMode

Obtém um valor que indica se esta célula está sendo editada no momento.
OwningColumn

Obtém a coluna que contém essa célula.
OwningRow

Obtém a linha que contém essa célula.
PreferredSize

Obtém o tamanho, em pixels, de uma área retangular na qual o controle pode caber.
ReadOnly

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.
RowIndex

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.
ToolTipText

Obtém ou define o texto de ToolTip associado à célula.
Value

Obtém ou define o valor associado a esta célula.
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.

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.
BorderWidths(DataGridViewAdvancedBorderStyle)

Retorna um Rectangle que representa a largura de todas as margens da célula.
ClickUnsharesRow(DataGridViewCellEventArgs)

Indica se linha da célula será descompartilhada quando a célula é clicada.
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.
ContentDoubleClickUnsharesRow(DataGridViewCellEventArgs)

Indica se linha da célula será descompartilhada quando o conteúdo da célula é clicado duas vezes.
CreateAccessibilityInstance()

Cria um novo objeto acessível para o DataGridViewCell.
DetachEditingControl()

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.
DoubleClickUnsharesRow(DataGridViewCellEventArgs)

Indica se linha da célula será descompartilhada quando a célula é clicada duas vezes.
EnterUnsharesRow(Int32, Boolean)

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.
GetClipboardContent(Int32, Boolean, Boolean, Boolean, Boolean, String)

Recupera o valor formatado da célula a ser copiado para o Clipboard.
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.
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.
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.
GetFormattedValue(Object, Int32, DataGridViewCellStyle, TypeConverter, TypeConverter, DataGridViewDataErrorContexts)

Obtém o valor da célula como formatado para exibição.
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.
GetInheritedState(Int32)

Retorna um valor que indica o estado atual da célula conforme herdado do estado da própria linha e coluna.
GetInheritedStyle(DataGridViewCellStyle, Int32, Boolean)

Obtém o estilo aplicado à célula.
GetPreferredSize(Graphics, DataGridViewCellStyle, Int32, Size)

Calcula o tamanho preferido da célula em pixels.
GetSize(Int32)

Obtém o tamanho da célula.
GetType()

Obtém o Type da instância atual.

(Herdado de Object)
GetValue(Int32)

Obtém o valor da célula.
InitializeEditingControl(Int32, Object, DataGridViewCellStyle)

Inicializa o controle usado para editar a célula.
KeyDownUnsharesRow(KeyEventArgs, Int32)

Indica se a linha pai é descompartilhada se o usuário pressionar uma tecla enquanto o foco está na célula.
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.
KeyUpUnsharesRow(KeyEventArgs, Int32)

Indica se a linha pai é descompartilhada quando o usuário libera uma tecla enquanto o foco está na célula.
LeaveUnsharesRow(Int32, Boolean)

Indica se uma linha será descompartilhada quando o foco sair de uma célula na linha.
MeasureTextHeight(Graphics, String, Font, Int32, TextFormatFlags)

Obtém a altura, em pixels, do texto especificado, dadas as características indicadas.
MeasureTextHeight(Graphics, String, Font, Int32, TextFormatFlags, Boolean)

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.
MeasureTextPreferredSize(Graphics, String, Font, Single, TextFormatFlags)

Obtém a altura e a largura ideal do texto especificado, dadas as características indicadas.
MeasureTextSize(Graphics, String, Font, TextFormatFlags)

Obtém a altura e a largura do texto especificado, dadas as características indicadas.
MeasureTextWidth(Graphics, String, Font, Int32, TextFormatFlags)

Obtém a largura, em pixels, do texto especificado, dadas as características indicadas.
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.
MouseDoubleClickUnsharesRow(DataGridViewCellMouseEventArgs)

Indica se uma linha será descompartilhada se o usuário clicar duas vezes em uma célula na linha.
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.
MouseEnterUnsharesRow(Int32)

Indica se uma linha será descompartilhada quando o ponteiro do mouse passar sobre uma célula na linha.
MouseLeaveUnsharesRow(Int32)

Indica se uma linha será descompartilhada quando o ponteiro do mouse sair da linha.
MouseMoveUnsharesRow(DataGridViewCellMouseEventArgs)

Indica se uma linha será descompartilhada quando o ponteiro do mouse passar sobre uma célula na linha.
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.
OnClick(DataGridViewCellEventArgs)

Chamado quando se clica na célula.
OnContentClick(DataGridViewCellEventArgs)

Chamado quando ocorre um clique no conteúdo da célula.
OnContentDoubleClick(DataGridViewCellEventArgs)

Chamado quando ocorre um clique duplo no conteúdo da célula.
OnDataGridViewChanged()

Chamado quando a propriedade DataGridView da célula é alterada.
OnDoubleClick(DataGridViewCellEventArgs)

Chamado quando ocorre um clique duplo na célula.
OnEnter(Int32, Boolean)

Chamado quando o foco chega a uma célula.
OnKeyDown(KeyEventArgs, Int32)

Chamado quando uma tecla de caractere é pressionada enquanto o foco está em uma célula.
OnKeyPress(KeyPressEventArgs, Int32)

Chamado quando uma tecla é pressionada enquanto o foco está em uma célula.
OnKeyUp(KeyEventArgs, Int32)

Chamado quando uma tecla de caractere é liberada enquanto o foco está em uma célula.
OnLeave(Int32, Boolean)

Chamado quando o foco sai de uma célula.
OnMouseClick(DataGridViewCellMouseEventArgs)

Chamado quando o usuário clica em um botão do mouse enquanto o ponteiro está em 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.
OnMouseDown(DataGridViewCellMouseEventArgs)

Chamado quando o usuário mantém o botão do mouse pressionado enquanto o ponteiro está em uma célula.
OnMouseEnter(Int32)

Chamado quando o ponteiro do mouse se move sobre uma célula.
OnMouseLeave(Int32)

Chamado quando o ponteiro do mouse deixa a célula.
OnMouseMove(DataGridViewCellMouseEventArgs)

Chamado quando o ponteiro do mouse se move dentro de uma célula.
OnMouseUp(DataGridViewCellMouseEventArgs)

Chamado quando o usuário solta o botão do mouse enquanto o ponteiro está em uma célula.
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.
PaintErrorIcon(Graphics, Rectangle, Rectangle, String)

Pinta o ícone de erro do DataGridViewCell atual.
ParseFormattedValue(Object, DataGridViewCellStyle, TypeConverter, TypeConverter)

Converte um valor formatado para exibição no valor real da célula.
PositionEditingControl(Boolean, Boolean, Rectangle, Rectangle, DataGridViewCellStyle, Boolean, Boolean, Boolean, Boolean)

Define o local e o tamanho do controle de 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.
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.
ToString()

Retorna uma cadeia de caracteres que descreve o objeto atual.

Aplica-se a

Confira também