Compartilhar via


DataGridViewRowErrorTextNeededEventHandler Delegar

Definição

Representa o método que manipulará o RowErrorTextNeeded evento de um DataGridView.

public delegate void DataGridViewRowErrorTextNeededEventHandler(System::Object ^ sender, DataGridViewRowErrorTextNeededEventArgs ^ e);
public delegate void DataGridViewRowErrorTextNeededEventHandler(object sender, DataGridViewRowErrorTextNeededEventArgs e);
public delegate void DataGridViewRowErrorTextNeededEventHandler(object? sender, DataGridViewRowErrorTextNeededEventArgs e);
type DataGridViewRowErrorTextNeededEventHandler = delegate of obj * DataGridViewRowErrorTextNeededEventArgs -> unit
Public Delegate Sub DataGridViewRowErrorTextNeededEventHandler(sender As Object, e As DataGridViewRowErrorTextNeededEventArgs)

Parâmetros

sender
Object

A fonte do evento.

Comentários

O RowErrorTextNeeded evento ocorre somente quando a DataGridView propriedade de controle DataSource é definida ou sua VirtualMode propriedade é true. Manipular o RowErrorTextNeeded evento é útil quando você deseja determinar o erro de uma linha, dependendo de seu estado e dos valores que ele contém.

Quando você manipula o RowErrorTextNeeded evento e especifica o texto de erro no manipulador, um glifo de erro aparece no cabeçalho da linha, a menos que a DataGridView.ShowRowErrors propriedade seja definida como false. Quando o usuário move o ponteiro do mouse sobre o glifo de erro, o texto de erro aparece em uma Dica de Ferramenta.

O RowErrorTextNeeded evento também ocorre sempre que o valor da DataGridViewRow.ErrorText propriedade é recuperado.

Você pode usar a DataGridViewRowErrorTextNeededEventArgs.RowIndex propriedade para determinar o estado ou o valor de uma linha e usar essas informações para alterar ou modificar a DataGridViewRowErrorTextNeededEventArgs.ErrorText propriedade. Essa propriedade é inicializada com o valor da propriedade de linha ErrorText , que o valor do evento substitui.

Manipule o RowErrorTextNeeded evento ao trabalhar com grandes quantidades de dados para evitar as penalidades de desempenho de definir o valor da linha ErrorText para várias linhas. Para obter mais informações, consulte As práticas recomendadas para dimensionar o controle DataGridView dos Windows Forms.

Para obter mais informações sobre como lidar com eventos, consulte Manipulando e levantando eventos.

Ao criar um DataGridViewRowErrorTextNeededEventHandler delegado, você identifica o método que manipulará o evento. Para associar o evento ao manipulador de eventos, adicione uma instância do delegado ao evento. O manipulador de eventos é chamado sempre que o evento ocorre, a menos que você remova o delegado. Para obter mais informações sobre representantes do manipulador de eventos, consulte Manipulando e levantando eventos.

Métodos de Extensão

Nome Description
GetMethodInfo(Delegate)

Obtém um objeto que representa o método representado pelo delegado especificado.

Aplica-se a

Confira também