DataGridView.RowHeightInfoNeeded Evento

Definição

Namespace:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

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;

member this.RowHeightInfoNeeded : System.Windows.Forms.DataGridViewRowHeightInfoNeededEventHandler 

Public Custom Event RowHeightInfoNeeded As DataGridViewRowHeightInfoNeededEventHandler 

Tipo de evento

DataGridViewRowHeightInfoNeededEventHandler

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.

Confira também

• RowHeightInfoPushed
• Controle DataGridView (Windows Forms)