DataGridView.IsCurrentCellDirty Propriedade

Definição

Namespace:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Obtém um valor que indica se a célula atual tem alterações não confirmadas.

public:
 property bool IsCurrentCellDirty { bool get(); };

[System.ComponentModel.Browsable(false)]
public bool IsCurrentCellDirty { get; }

[<System.ComponentModel.Browsable(false)>]
member this.IsCurrentCellDirty : bool

Public ReadOnly Property IsCurrentCellDirty As Boolean

Valor da propriedade

Boolean

true se a célula atual tiver alterações não confirmadas, caso contrário, false.

Atributos

BrowsableAttribute

Exemplos

O exemplo de código a seguir usa a IsCurrentCellDirty propriedade para determinar se um valor de célula deve ser confirmado e gerar o CellValueChanged evento de um manipulador para o CurrentCellDirtyStateChanged evento. Este exemplo de código faz parte de um exemplo maior fornecido em How to: Disable Buttons in a Button Column in the Windows Forms DataGridView Control.

// This event handler manually raises the CellValueChanged event
// by calling the CommitEdit method.
void dataGridView1_CurrentCellDirtyStateChanged(object sender,
    EventArgs e)
{
    if (dataGridView1.IsCurrentCellDirty)
    {
        dataGridView1.CommitEdit(DataGridViewDataErrorContexts.Commit);
    }
}

// If a check box cell is clicked, this event handler disables  
// or enables the button in the same row as the clicked cell.
public void dataGridView1_CellValueChanged(object sender,
    DataGridViewCellEventArgs e)
{
    if (dataGridView1.Columns[e.ColumnIndex].Name == "CheckBoxes")
    {
        DataGridViewDisableButtonCell buttonCell =
            (DataGridViewDisableButtonCell)dataGridView1.
            Rows[e.RowIndex].Cells["Buttons"];

        DataGridViewCheckBoxCell checkCell =
            (DataGridViewCheckBoxCell)dataGridView1.
            Rows[e.RowIndex].Cells["CheckBoxes"];
        buttonCell.Enabled = !(Boolean)checkCell.Value;

        dataGridView1.Invalidate();
    }
}

' This event handler manually raises the CellValueChanged event
' by calling the CommitEdit method.
Sub dataGridView1_CurrentCellDirtyStateChanged( _
    ByVal sender As Object, ByVal e As EventArgs) _
    Handles dataGridView1.CurrentCellDirtyStateChanged

    If dataGridView1.IsCurrentCellDirty Then
        dataGridView1.CommitEdit(DataGridViewDataErrorContexts.Commit)
    End If
End Sub

' If a check box cell is clicked, this event handler disables  
' or enables the button in the same row as the clicked cell.
Public Sub dataGridView1_CellValueChanged(ByVal sender As Object, _
    ByVal e As DataGridViewCellEventArgs) _
    Handles dataGridView1.CellValueChanged

    If dataGridView1.Columns(e.ColumnIndex).Name = "CheckBoxes" Then
        Dim buttonCell As DataGridViewDisableButtonCell = _
            CType(dataGridView1.Rows(e.RowIndex).Cells("Buttons"), _
            DataGridViewDisableButtonCell)

        Dim checkCell As DataGridViewCheckBoxCell = _
            CType(dataGridView1.Rows(e.RowIndex).Cells("CheckBoxes"), _
            DataGridViewCheckBoxCell)
        buttonCell.Enabled = Not CType(checkCell.Value, [Boolean])

        dataGridView1.Invalidate()
    End If
End Sub

Comentários

Quando o DataGridView não está associado a dados, a edição de célula é considerada confirmada quando o usuário se move para outra célula.

Se os cabeçalhos de linha estiverem visíveis, um glifo de lápis estará presente no cabeçalho da linha que contém uma célula com alterações não confirmadas.

Se IsCurrentCellDirty for true e a célula atual hospedar um controle de edição, você poderá recuperá-lo por meio da EditingControl propriedade .

Confira também

• Controle DataGridView (Windows Forms)