DataGridView.RowHeightInfoNeeded Evento
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Ocorre quando as informações sobre a altura da linha são solicitadas.
public:
event System::Windows::Forms::DataGridViewRowHeightInfoNeededEventHandler ^ RowHeightInfoNeeded;
public event System.Windows.Forms.DataGridViewRowHeightInfoNeededEventHandler RowHeightInfoNeeded;
public event System.Windows.Forms.DataGridViewRowHeightInfoNeededEventHandler? RowHeightInfoNeeded;
member this.RowHeightInfoNeeded : System.Windows.Forms.DataGridViewRowHeightInfoNeededEventHandler
Public Custom Event RowHeightInfoNeeded As DataGridViewRowHeightInfoNeededEventHandler
Tipo de evento
Exemplos
O exemplo de código a seguir demonstra o uso desse membro. No exemplo, um manipulador de eventos relata a ocorrência do RowHeightInfoNeeded evento. Este relatório ajuda você a saber quando o evento ocorre e pode ajudá-lo na depuração. Para relatar vários eventos ou eventos que ocorrem com frequência, considere substituir MessageBox.ShowConsole.WriteLine por ou acrescentar a mensagem a uma multilinha TextBox.
Para executar o código de exemplo, cole-o em um projeto que contém uma instância do tipo DataGridView chamada DataGridView1
. Em seguida, verifique se o manipulador de eventos está associado ao RowHeightInfoNeeded evento.
private void DataGridView1_RowHeightInfoNeeded(Object sender, DataGridViewRowHeightInfoNeededEventArgs e) {
System.Text.StringBuilder messageBoxCS = new System.Text.StringBuilder();
messageBoxCS.AppendFormat("{0} = {1}", "Height", e.Height );
messageBoxCS.AppendLine();
messageBoxCS.AppendFormat("{0} = {1}", "MinimumHeight", e.MinimumHeight );
messageBoxCS.AppendLine();
messageBoxCS.AppendFormat("{0} = {1}", "RowIndex", e.RowIndex );
messageBoxCS.AppendLine();
MessageBox.Show(messageBoxCS.ToString(), "RowHeightInfoNeeded Event" );
}
Private Sub DataGridView1_RowHeightInfoNeeded(sender as Object, e as DataGridViewRowHeightInfoNeededEventArgs) _
Handles DataGridView1.RowHeightInfoNeeded
Dim messageBoxVB as New System.Text.StringBuilder()
messageBoxVB.AppendFormat("{0} = {1}", "Height", e.Height)
messageBoxVB.AppendLine()
messageBoxVB.AppendFormat("{0} = {1}", "MinimumHeight", e.MinimumHeight)
messageBoxVB.AppendLine()
messageBoxVB.AppendFormat("{0} = {1}", "RowIndex", e.RowIndex)
messageBoxVB.AppendLine()
MessageBox.Show(messageBoxVB.ToString(),"RowHeightInfoNeeded Event")
End Sub
Comentários
Esse evento é útil para preservar alturas de linha personalizadas após uma operação de classificação. Isso é necessário porque as operações de classificação normalmente são tratadas pela fonte de dados, o que não controla a correspondência entre linhas de dados e linhas no controle. Esse evento ocorre somente quando a DataSource propriedade foi definida ou quando a VirtualMode propriedade é true
. No último caso, você fornece seu próprio armazenamento de dados e operações de classificação. Manipule o RowHeightInfoPushed evento para armazenar informações de altura atualizadas quando o usuário alterar a altura de uma linha. Use RowHeightInfoNeeded para recuperar as informações de altura armazenadas quando o controle precisar dela.
Para obter mais informações sobre como lidar com eventos, consulte Manipulando e gerando eventos.