DataGridView.RowHeightInfoNeeded 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 é solicitada informação sobre a altura das filas.
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 seguinte exemplo de código demonstra a utilização deste elemento. No exemplo, um gestor de eventos reporta a ocorrência do RowHeightInfoNeeded evento. Este relatório ajuda-o a saber quando o evento ocorre e pode ajudá-lo na depuração. Para reportar múltiplos eventos ou eventos que ocorrem frequentemente, considere substituir MessageBox.Show ou Console.WriteLine anexar a mensagem a uma multilinha TextBox.
Para executar o código de exemplo, cole-o num projeto que contenha uma instância do tipo DataGridView chamada DataGridView1. Depois, certifique-se de que o gestor 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
Observações
Este evento é útil para preservar alturas de linhas personalizadas após uma operação de ordenação. Isto é necessário porque as operações de ordenação são normalmente tratadas pela fonte de dados, que não acompanha a correspondência entre linhas de dados e linhas no controlo. Este evento ocorre apenas quando a DataSource propriedade foi definida ou quando a VirtualMode propriedade é true. Neste último caso, fornece o seu próprio armazenamento de dados e operações de ordenação. Gere o RowHeightInfoPushed evento para armazenar informação atualizada de altura quando o utilizador alterar a altura de uma linha. Use RowHeightInfoNeeded para recuperar a informação de altura armazenada quando o controlo precisa.
Para mais informações sobre como gerir eventos, consulte Gestão e Levantamento de Eventos.