DataGridViewCell Classe

Definição

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

Representa uma célula individual em um DataGridView controle.

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 Como adicionar dicas de ferramenta a células individuais em um controle Windows Forms DataGridView.

// 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 para identificar DataGridViewCell a localização da célula no DataGridView. Uma célula típica contém dados específicos para a linha e a coluna em que ela está contida. A célula pode ser personalizada de várias maneiras definindo suas propriedades e tratando os eventos associados a ela.

Notas aos Implementadores

Ao derivar e DataGridViewCell 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

Nome Description
DataGridViewCell()

Inicializa uma nova instância da classe DataGridViewCell.

Propriedades

Nome Description
AccessibilityObject

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

Obtém o índice de coluna dessa célula.
ContentBounds

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

Obtém ou define o menu de atalho associado à célula.
DataGridView

Obtém o DataGridView controle associado a esse elemento.

(Herdado de DataGridViewElement)
DefaultNewRowValue

Obtém o valor padrão de uma célula na linha para novos registros.
Displayed

Obtém um valor que indica se a célula é exibida atualmente na tela.
EditedFormattedValue

Obtém o valor atual formatado da célula, independentemente de a célula estar no modo de edição e se o valor não foi confirmado.
EditType

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

Obtém os limites do ícone de erro da 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 Style propriedade 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 essa 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 a célula pode se ajustar.
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 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 tooltip associado a essa célula.
Value

Obtém ou define o valor associado a essa 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 oculta.

Métodos

Nome Description
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 as larguras de todas as margens da célula.
ClickUnsharesRow(DataGridViewCellEventArgs)

Indica se a linha da célula será desarmada quando a célula for clicada.
Clone()

Cria uma cópia exata dessa célula.
ContentClickUnsharesRow(DataGridViewCellEventArgs)

Indica se a linha da célula será desarmada quando o conteúdo da célula for clicado.
ContentDoubleClickUnsharesRow(DataGridViewCellEventArgs)

Indica se a linha da célula será desarmada quando o conteúdo da célula for 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 a linha da célula será desarmada quando a célula for clicada duas vezes.
EnterUnsharesRow(Int32, Boolean)

Indica se a linha pai será desarmada quando o foco se mover 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 de serem DataGridViewCell recuperados 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 estilo de célula e especificado Graphics .
GetContentBounds(Int32)

Retorna o retângulo delimitador que inclui a área de conteúdo da célula usando um padrão Graphics e um estilo de célula atualmente em vigor para a célula.
GetEditedFormattedValue(Int32, DataGridViewDataErrorContexts)

Retorna o valor atual formatado da célula, independentemente de a célula estar no modo de edição e se 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 um for 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 hash predefinida.

(Herdado de Object)
GetInheritedContextMenuStrip(Int32)

Obtém o menu de atalho herdado da célula atual.
GetInheritedState(Int32)

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

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

Calcula o tamanho preferencial, em pixels, da célula.
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 está desarmada se o usuário pressiona 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 fornecida.
KeyPressUnsharesRow(KeyPressEventArgs, Int32)

Indica se uma linha será desarmada se uma tecla for pressionada enquanto uma célula na linha tiver foco.
KeyUpUnsharesRow(KeyEventArgs, Int32)

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

Indica se uma linha será desarmada quando o foco deixar uma célula na linha.
MeasureTextHeight(Graphics, String, Font, Int32, TextFormatFlags, Boolean)

Obtém a altura, em pixels, do texto especificado, dadas as características especificadas. Também indica se a largura necessária é maior que a largura máxima especificada.
MeasureTextHeight(Graphics, String, Font, Int32, TextFormatFlags)

Obtém a altura, em pixels, do texto especificado, dadas as características especificadas.
MeasureTextPreferredSize(Graphics, String, Font, Single, TextFormatFlags)

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

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

Obtém a largura, em pixels, do texto especificado dadas as características especificadas.
MemberwiseClone()

Cria uma cópia superficial do Objectatual.

(Herdado de Object)
MouseClickUnsharesRow(DataGridViewCellMouseEventArgs)

Indica se uma linha será desarmada se o usuário clicar em um botão do mouse enquanto o ponteiro estiver em uma célula na linha.
MouseDoubleClickUnsharesRow(DataGridViewCellMouseEventArgs)

Indica se uma linha será desarmada se o usuário clicar duas vezes em uma célula na linha.
MouseDownUnsharesRow(DataGridViewCellMouseEventArgs)

Indica se uma linha será desarmada quando o usuário segurar um botão do mouse enquanto o ponteiro estiver em uma célula na linha.
MouseEnterUnsharesRow(Int32)

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

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

Indica se uma linha será desarmada quando o ponteiro do mouse se mover sobre uma célula na linha.
MouseUpUnsharesRow(DataGridViewCellMouseEventArgs)

Indica se uma linha será desarmada quando o usuário liberar um botão do mouse enquanto o ponteiro estiver em uma célula na linha.
OnClick(DataGridViewCellEventArgs)

Chamado quando a célula é clicada.
OnContentClick(DataGridViewCellEventArgs)

Chamado quando o conteúdo da célula é clicado.
OnContentDoubleClick(DataGridViewCellEventArgs)

Chamado quando o conteúdo da célula é clicado duas vezes.
OnDataGridViewChanged()

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

Chamado quando a célula é clicada duas vezes.
OnEnter(Int32, Boolean)

Chamado quando o foco se move para 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 chave de caractere é liberada enquanto o foco está em uma célula.
OnLeave(Int32, Boolean)

Chamado quando o foco se move 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 segura um botão do mouse 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 sai da célula.
OnMouseMove(DataGridViewCellMouseEventArgs)

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

Chamado quando o usuário libera um 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 atual DataGridViewCell.
PaintBorder(Graphics, Rectangle, Rectangle, DataGridViewCellStyle, DataGridViewAdvancedBorderStyle)

Pinta a borda da corrente DataGridViewCell.
PaintErrorIcon(Graphics, Rectangle, Rectangle, String)

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

Converte um valor formatado para exibição em um valor de célula real.
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 DataGridView controle.
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