DataGridViewCell Classe

Definição

Representa uma célula individual em um controle DataGridView.Represents an individual cell in a DataGridView control.

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
type DataGridViewCell = class
    inherit DataGridViewElement
    interface ICloneable
    interface IDisposable
Public MustInherit Class DataGridViewCell
Inherits DataGridViewElement
Implements ICloneable, IDisposable
Herança
DataGridViewCell
Derivado
Atributos
Implementações

Exemplos

O exemplo de código a seguir ilustra o uso desse tipo.The following code example illustrates the use of this type. Para obter mais informações sobre este exemplo, consulte como: Adicione dicas de ferramentas a células individuais em umde controle Windows Forms DataGridView.For more information about this example, see 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 classe DataGridViewCell representa uma célula individual em um controle de DataGridView.The DataGridViewCell class represents an individual cell in a DataGridView control. Você pode recuperar células por meio da coleção de Cells de um DataGridViewRow.You can retrieve cells through the Cells collection of a DataGridViewRow.

A linha e a coluna de um DataGridViewCell identificam o local da célula na DataGridView.The row and column for a DataGridViewCell identify the cell's location in the DataGridView. Uma célula típica contém dados específicos para a linha e coluna nas quais ele está contido.A typical cell contains data specific to the row and column in which it is contained. A célula pode ser personalizada de várias maneiras definindo suas propriedades e manipulando os eventos associados a ela.The cell can be customized in a number of ways by setting its properties and handling the events associated with it.

Notas aos Implementadores

Quando você deriva de DataGridViewCell e adiciona novas propriedades à classe derivada, certifique-se de substituir o método Clone() para copiar as novas propriedades durante as operações de clonagem.When you derive from DataGridViewCell and add new properties to the derived class, be sure to override the Clone() method to copy the new properties during cloning operations. Você também deve chamar o método Clone() da classe base para que as propriedades da classe base sejam copiadas para a nova célula.You should also call the base class's Clone() method so that the properties of the base class are copied to the new cell.

Construtores

DataGridViewCell()

Inicializa uma nova instância da classe DataGridViewCell.Initializes a new instance of the DataGridViewCell class.

Propriedades

AccessibilityObject

Obtém o DataGridViewCell.DataGridViewCellAccessibleObject atribuído ao DataGridViewCell.Gets the DataGridViewCell.DataGridViewCellAccessibleObject assigned to the DataGridViewCell.

ColumnIndex

Obtém o índice da coluna para essa célula.Gets the column index for this cell.

ContentBounds

Obtém o retângulo delimitador que circunscreve a área de conteúdo da célula.Gets the bounding rectangle that encloses the cell's content area.

ContextMenuStrip

Obtém ou define o menu de atalho associado à célula.Gets or sets the shortcut menu associated with the cell.

DataGridView

Obtém o controle de DataGridView associado a esse elemento.Gets the DataGridView control associated with this element.

(Herdado de DataGridViewElement)
DefaultNewRowValue

Obtém o valor padrão para uma célula na linha para novos registros.Gets the default value for a cell in the row for new records.

Displayed

Obtém um valor que indica se a célula é exibida na tela no momento.Gets a value that indicates whether the cell is currently displayed on-screen.

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.Gets the current, formatted value of the cell, regardless of whether the cell is in edit mode and the value has not been committed.

EditType

Obtém o tipo de controle de edição hospedado da célula.Gets the type of the cell's hosted editing control.

ErrorIconBounds

Obtém os limites do ícone de erro para a célula.Gets the bounds of the error icon for the cell.

ErrorText

Obtém ou define o texto que descreve uma condição de erro associada à célula.Gets or sets the text describing an error condition associated with the cell.

FormattedValue

Obtém o valor da célula como formatado para exibição.Gets the value of the cell as formatted for display.

FormattedValueType

Obtém o tipo do valor formatado associado à célula.Gets the type of the formatted value associated with the cell.

Frozen

Obtém um valor que indica se a célula está congelada.Gets a value indicating whether the cell is frozen.

HasStyle

Obtém um valor que indica se a propriedade Style foi definida.Gets a value indicating whether the Style property has been set.

InheritedState

Obtém o estado atual da célula conforme herdado do estado de sua linha e coluna.Gets the current state of the cell as inherited from the state of its row and column.

InheritedStyle

Obtém o estilo atualmente aplicado à célula.Gets the style currently applied to the cell.

IsInEditMode

Obtém um valor que indica se esta célula está sendo editada no momento.Gets a value indicating whether this cell is currently being edited.

OwningColumn

Obtém a coluna que contém essa célula.Gets the column that contains this cell.

OwningRow

Obtém a linha que contém essa célula.Gets the row that contains this cell.

PreferredSize

Obtém o tamanho, em pixels, de uma área retangular na qual o controle pode caber.Gets the size, in pixels, of a rectangular area into which the cell can fit.

ReadOnly

Obtém ou define um valor que indica se os dados da célula podem ser editados.Gets or sets a value indicating whether the cell's data can be edited.

Resizable

Obtém um valor que indica se a célula pode ser redimensionada.Gets a value indicating whether the cell can be resized.

RowIndex

Obtém o índice da linha pai da célula.Gets the index of the cell's parent row.

Selected

Obtém ou define um valor que indica se a célula foi selecionada.Gets or sets a value indicating whether the cell has been selected.

Size

Obtém o tamanho da célula.Gets the size of the cell.

State

Obtém o estado da UI (interface do usuário) do elemento.Gets the user interface (UI) state of the element.

(Herdado de DataGridViewElement)
Style

Obtém ou define o estilo da célula.Gets or sets the style for the cell.

Tag

Obtém ou define o objeto que contém dados complementares sobre a célula.Gets or sets the object that contains supplemental data about the cell.

ToolTipText

Obtém ou define o texto de ToolTip associado à célula.Gets or sets the ToolTip text associated with this cell.

Value

Obtém ou define o valor associado a esta célula.Gets or sets the value associated with this cell.

ValueType

Obtém ou define o tipo de dados dos valores na célula.Gets or sets the data type of the values in the cell.

Visible

Obtém um valor que indica se a célula está em uma linha ou coluna ocultada.Gets a value indicating whether the cell is in a row or column that has been hidden.

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.Modifies the input cell border style according to the specified criteria.

BorderWidths(DataGridViewAdvancedBorderStyle)

Retorna um Rectangle que representa a largura de todas as margens da célula.Returns a Rectangle that represents the widths of all the cell margins.

ClickUnsharesRow(DataGridViewCellEventArgs)

Indica se linha da célula será descompartilhada quando a célula é clicada.Indicates whether the cell's row will be unshared when the cell is clicked.

Clone()

Cria uma cópia exata desta célula.Creates an exact copy of this cell.

ContentClickUnsharesRow(DataGridViewCellEventArgs)

Indica se linha da célula será descompartilhada quando o conteúdo da célula é clicado.Indicates whether the cell's row will be unshared when the cell's content is clicked.

ContentDoubleClickUnsharesRow(DataGridViewCellEventArgs)

Indica se linha da célula será descompartilhada quando o conteúdo da célula é clicado duas vezes.Indicates whether the cell's row will be unshared when the cell's content is double-clicked.

CreateAccessibilityInstance()

Cria um novo objeto acessível para o DataGridViewCell.Creates a new accessible object for the DataGridViewCell.

DetachEditingControl()

Remove o controle de edição da célula do DataGridView.Removes the cell's editing control from the DataGridView.

Dispose()

Libera todos os recursos usados pelo DataGridViewCell.Releases all resources used by the DataGridViewCell.

Dispose(Boolean)

Libera os recursos não gerenciados usados pelo DataGridViewCell e opcionalmente libera os recursos gerenciados.Releases the unmanaged resources used by the DataGridViewCell and optionally releases the managed resources.

DoubleClickUnsharesRow(DataGridViewCellEventArgs)

Indica se linha da célula será descompartilhada quando a célula é clicada duas vezes.Indicates whether the cell's row will be unshared when the cell is double-clicked.

EnterUnsharesRow(Int32, Boolean)

Indica se a linha pai será descompartilhada quando o foto se move para a célula.Indicates whether the parent row will be unshared when the focus moves to the cell.

Equals(Object)

Determina se o objeto especificado é igual ao objeto atual.Determines whether the specified object is equal to the current object.

(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.Releases the unmanaged resources and performs other cleanup operations before the DataGridViewCell is reclaimed by garbage collection.

GetClipboardContent(Int32, Boolean, Boolean, Boolean, Boolean, String)

Recupera o valor formatado da célula a ser copiado para o Clipboard.Retrieves the formatted value of the cell to copy to the 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.Returns the bounding rectangle that encloses the cell's content area, which is calculated using the specified Graphics and cell style.

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.Returns the bounding rectangle that encloses the cell's content area using a default Graphics and cell style currently in effect for the cell.

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.Returns the current, formatted value of the cell, regardless of whether the cell is in edit mode and the value has not been committed.

GetErrorIconBounds(Graphics, DataGridViewCellStyle, Int32)

Retorna o retângulo delimitador que inclui o ícone de erro da célula, se exibido.Returns the bounding rectangle that encloses the cell's error icon, if one is displayed.

GetErrorText(Int32)

Retorna uma cadeia de caracteres que representa o erro da célula.Returns a string that represents the error for the cell.

GetFormattedValue(Object, Int32, DataGridViewCellStyle, TypeConverter, TypeConverter, DataGridViewDataErrorContexts)

Obtém o valor da célula como formatado para exibição.Gets the value of the cell as formatted for display.

GetHashCode()

Serve como a função de hash padrão.Serves as the default hash function.

(Herdado de Object)
GetInheritedContextMenuStrip(Int32)

Obtém o menu de atalho herdado para a célula atual.Gets the inherited shortcut menu for the current cell.

GetInheritedState(Int32)

Retorna um valor que indica o estado atual da célula conforme herdado do estado da própria linha e coluna.Returns a value indicating the current state of the cell as inherited from the state of its row and column.

GetInheritedStyle(DataGridViewCellStyle, Int32, Boolean)

Obtém o estilo aplicado à célula.Gets the style applied to the cell.

GetPreferredSize(Graphics, DataGridViewCellStyle, Int32, Size)

Calcula o tamanho preferido da célula em pixels.Calculates the preferred size, in pixels, of the cell.

GetSize(Int32)

Obtém o tamanho da célula.Gets the size of the cell.

GetType()

Obtém o Type da instância atual.Gets the Type of the current instance.

(Herdado de Object)
GetValue(Int32)

Obtém o valor da célula.Gets the value of the cell.

InitializeEditingControl(Int32, Object, DataGridViewCellStyle)

Inicializa o controle usado para editar a célula.Initializes the control used to edit the cell.

KeyDownUnsharesRow(KeyEventArgs, Int32)

Indica se a linha pai é descompartilhada se o usuário pressionar uma tecla enquanto o foco está na célula.Indicates whether the parent row is unshared if the user presses a key while the focus is on the cell.

KeyEntersEditMode(KeyEventArgs)

Determina se o modo de edição deve ser iniciado com base na chave especificada.Determines if edit mode should be started based on the given key.

KeyPressUnsharesRow(KeyPressEventArgs, Int32)

Indica se uma linha será descompartilhada se uma tecla for pressionada enquanto uma célula na linha tem o foco.Indicates whether a row will be unshared if a key is pressed while a cell in the row has focus.

KeyUpUnsharesRow(KeyEventArgs, Int32)

Indica se a linha pai é descompartilhada quando o usuário libera uma tecla enquanto o foco está na célula.Indicates whether the parent row is unshared when the user releases a key while the focus is on the cell.

LeaveUnsharesRow(Int32, Boolean)

Indica se uma linha será descompartilhada quando o foco sair de uma célula na linha.Indicates whether a row will be unshared when the focus leaves a cell in the row.

MeasureTextHeight(Graphics, String, Font, Int32, TextFormatFlags)

Obtém a altura, em pixels, do texto especificado, dadas as características indicadas.Gets the height, in pixels, of the specified text, given the specified characteristics.

MeasureTextHeight(Graphics, String, Font, Int32, TextFormatFlags, Boolean)

Obtém a altura, em pixels, do texto especificado, dadas as características indicadas.Gets the height, in pixels, of the specified text, given the specified characteristics. Também indica se a largura necessária é maior que a largura máxima especificada.Also indicates whether the required width is greater than the specified maximum width.

MeasureTextPreferredSize(Graphics, String, Font, Single, TextFormatFlags)

Obtém a altura e a largura ideal do texto especificado, dadas as características indicadas.Gets the ideal height and width of the specified text given the specified characteristics.

MeasureTextSize(Graphics, String, Font, TextFormatFlags)

Obtém a altura e a largura do texto especificado, dadas as características indicadas.Gets the height and width of the specified text given the specified characteristics.

MeasureTextWidth(Graphics, String, Font, Int32, TextFormatFlags)

Obtém a largura, em pixels, do texto especificado, dadas as características indicadas.Gets the width, in pixels, of the specified text given the specified characteristics.

MemberwiseClone()

Cria uma cópia superficial do Object atual.Creates a shallow copy of the current Object.

(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.Indicates whether a row will be unshared if the user clicks a mouse button while the pointer is on a cell in the row.

MouseDoubleClickUnsharesRow(DataGridViewCellMouseEventArgs)

Indica se uma linha será descompartilhada se o usuário clicar duas vezes em uma célula na linha.Indicates whether a row will be unshared if the user double-clicks a cell in the row.

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.Indicates whether a row will be unshared when the user holds down a mouse button while the pointer is on a cell in the row.

MouseEnterUnsharesRow(Int32)

Indica se uma linha será descompartilhada quando o ponteiro do mouse passar sobre uma célula na linha.Indicates whether a row will be unshared when the mouse pointer moves over a cell in the row.

MouseLeaveUnsharesRow(Int32)

Indica se uma linha será descompartilhada quando o ponteiro do mouse sair da linha.Indicates whether a row will be unshared when the mouse pointer leaves the row.

MouseMoveUnsharesRow(DataGridViewCellMouseEventArgs)

Indica se uma linha será descompartilhada quando o ponteiro do mouse passar sobre uma célula na linha.Indicates whether a row will be unshared when the mouse pointer moves over a cell in the row.

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.Indicates whether a row will be unshared when the user releases a mouse button while the pointer is on a cell in the row.

OnClick(DataGridViewCellEventArgs)

Chamado quando se clica na célula.Called when the cell is clicked.

OnContentClick(DataGridViewCellEventArgs)

Chamado quando ocorre um clique no conteúdo da célula.Called when the cell's contents are clicked.

OnContentDoubleClick(DataGridViewCellEventArgs)

Chamado quando ocorre um clique duplo no conteúdo da célula.Called when the cell's contents are double-clicked.

OnDataGridViewChanged()

Chamado quando a propriedade DataGridView da célula é alterada.Called when the DataGridView property of the cell changes.

OnDoubleClick(DataGridViewCellEventArgs)

Chamado quando ocorre um clique duplo na célula.Called when the cell is double-clicked.

OnEnter(Int32, Boolean)

Chamado quando o foco chega a uma célula.Called when the focus moves to a cell.

OnKeyDown(KeyEventArgs, Int32)

Chamado quando uma tecla de caractere é pressionada enquanto o foco está em uma célula.Called when a character key is pressed while the focus is on a cell.

OnKeyPress(KeyPressEventArgs, Int32)

Chamado quando uma tecla é pressionada enquanto o foco está em uma célula.Called when a key is pressed while the focus is on a cell.

OnKeyUp(KeyEventArgs, Int32)

Chamado quando uma tecla de caractere é liberada enquanto o foco está em uma célula.Called when a character key is released while the focus is on a cell.

OnLeave(Int32, Boolean)

Chamado quando o foco sai de uma célula.Called when the focus moves from a cell.

OnMouseClick(DataGridViewCellMouseEventArgs)

Chamado quando o usuário clica em um botão do mouse enquanto o ponteiro está em uma célula.Called when the user clicks a mouse button while the pointer is on a cell.

OnMouseDoubleClick(DataGridViewCellMouseEventArgs)

Chamado quando o usuário clica duas vezes em um botão do mouse enquanto o ponteiro está em uma célula.Called when the user double-clicks a mouse button while the pointer is on a cell.

OnMouseDown(DataGridViewCellMouseEventArgs)

Chamado quando o usuário mantém o botão do mouse pressionado enquanto o ponteiro está em uma célula.Called when the user holds down a mouse button while the pointer is on a cell.

OnMouseEnter(Int32)

Chamado quando o ponteiro do mouse se move sobre uma célula.Called when the mouse pointer moves over a cell.

OnMouseLeave(Int32)

Chamado quando o ponteiro do mouse deixa a célula.Called when the mouse pointer leaves the cell.

OnMouseMove(DataGridViewCellMouseEventArgs)

Chamado quando o ponteiro do mouse se move dentro de uma célula.Called when the mouse pointer moves within a cell.

OnMouseUp(DataGridViewCellMouseEventArgs)

Chamado quando o usuário solta o botão do mouse enquanto o ponteiro está em uma célula.Called when the user releases a mouse button while the pointer is on a cell.

Paint(Graphics, Rectangle, Rectangle, Int32, DataGridViewElementStates, Object, Object, String, DataGridViewCellStyle, DataGridViewAdvancedBorderStyle, DataGridViewPaintParts)

Pinta o DataGridViewCell atual.Paints the current DataGridViewCell.

PaintBorder(Graphics, Rectangle, Rectangle, DataGridViewCellStyle, DataGridViewAdvancedBorderStyle)

Pinta a borda do DataGridViewCell atual.Paints the border of the current DataGridViewCell.

PaintErrorIcon(Graphics, Rectangle, Rectangle, String)

Pinta o ícone de erro do DataGridViewCell atual.Paints the error icon of the current DataGridViewCell.

ParseFormattedValue(Object, DataGridViewCellStyle, TypeConverter, TypeConverter)

Converte um valor formatado para exibição no valor real da célula.Converts a value formatted for display to an actual cell value.

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.Sets the location and size of the editing control hosted by a cell in the DataGridView control.

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.Sets the location and size of the editing panel hosted by the cell, and returns the normal bounds of the editing control within the editing panel.

RaiseCellClick(DataGridViewCellEventArgs)

Aciona o evento CellClick.Raises the CellClick event.

(Herdado de DataGridViewElement)
RaiseCellContentClick(DataGridViewCellEventArgs)

Aciona o evento CellContentClick.Raises the CellContentClick event.

(Herdado de DataGridViewElement)
RaiseCellContentDoubleClick(DataGridViewCellEventArgs)

Aciona o evento CellContentDoubleClick.Raises the CellContentDoubleClick event.

(Herdado de DataGridViewElement)
RaiseCellValueChanged(DataGridViewCellEventArgs)

Aciona o evento CellValueChanged.Raises the CellValueChanged event.

(Herdado de DataGridViewElement)
RaiseDataError(DataGridViewDataErrorEventArgs)

Aciona o evento DataError.Raises the DataError event.

(Herdado de DataGridViewElement)
RaiseMouseWheel(MouseEventArgs)

Aciona o evento MouseWheel.Raises the MouseWheel event.

(Herdado de DataGridViewElement)
SetValue(Int32, Object)

Define o valor da célula.Sets the value of the cell.

ToString()

Retorna uma cadeia de caracteres que descreve o objeto atual.Returns a string that describes the current object.

Aplica-se a

Veja também