DataGridView.CellEndEdit Evento
Definição
Importante
Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.
Ocorre quando o modo de edição para a célula atualmente selecionada.
public:
event System::Windows::Forms::DataGridViewCellEventHandler ^ CellEndEdit;
public event System.Windows.Forms.DataGridViewCellEventHandler CellEndEdit;
member this.CellEndEdit : System.Windows.Forms.DataGridViewCellEventHandler
Public Custom Event CellEndEdit As DataGridViewCellEventHandler
Tipo de Evento
Exemplos
O exemplo de código seguinte ilustra como lidar com este evento para limpar a propriedade da linha DataGridViewRow.ErrorText caso tenha sido previamente definida por um CellValidating gestor de eventos. O CellValidating gestor de eventos pode limpar o texto de erro quando o novo valor da célula cumpre os critérios de validação, mas quando o utilizador reverte para o valor da célula antiga ao pressionar ESC, o CellValidating evento não ocorre. Este exemplo faz parte de um exemplo mais amplo disponível em Walkthrough: Validating Data in the Windows Forms DataGridView Control.
private void dataGridView1_CellValidating(object sender,
DataGridViewCellValidatingEventArgs e)
{
string headerText =
dataGridView1.Columns[e.ColumnIndex].HeaderText;
// Abort validation if cell is not in the CompanyName column.
if (!headerText.Equals("CompanyName")) return;
// Confirm that the cell is not empty.
if (string.IsNullOrEmpty(e.FormattedValue.ToString()))
{
dataGridView1.Rows[e.RowIndex].ErrorText =
"Company Name must not be empty";
e.Cancel = true;
}
}
void dataGridView1_CellEndEdit(object sender, DataGridViewCellEventArgs e)
{
// Clear the row error in case the user presses ESC.
dataGridView1.Rows[e.RowIndex].ErrorText = String.Empty;
}
Private Sub dataGridView1_CellValidating(ByVal sender As Object, _
ByVal e As DataGridViewCellValidatingEventArgs) _
Handles dataGridView1.CellValidating
Dim headerText As String = _
dataGridView1.Columns(e.ColumnIndex).HeaderText
' Abort validation if cell is not in the CompanyName column.
If Not headerText.Equals("CompanyName") Then Return
' Confirm that the cell is not empty.
If (String.IsNullOrEmpty(e.FormattedValue.ToString())) Then
dataGridView1.Rows(e.RowIndex).ErrorText = _
"Company Name must not be empty"
e.Cancel = True
End If
End Sub
Private Sub dataGridView1_CellEndEdit(ByVal sender As Object, _
ByVal e As System.Windows.Forms.DataGridViewCellEventArgs) _
Handles dataGridView1.CellEndEdit
' Clear the row error in case the user presses ESC.
dataGridView1.Rows(e.RowIndex).ErrorText = String.Empty
End Sub
Observações
Para mais informações sobre como gerir eventos, consulte Gestão e Levantamento de Eventos.