DataGridView.RowHeightInfoNeeded Événement

Définition

Se produit lorsque des informations sur la hauteur de ligne sont demandées.Occurs when information about row height is requested.

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 

Exemples

L’exemple de code suivant illustre l’utilisation de ce membre.The following code example demonstrates the use of this member. Dans l’exemple, un gestionnaire d’événements signale l’occurrence de l’événement RowHeightInfoNeeded.In the example, an event handler reports on the occurrence of the RowHeightInfoNeeded event. Ce rapport vous aide à savoir quand l’événement se produit et peut vous aider à effectuer un débogage.This report helps you to learn when the event occurs and can assist you in debugging. Pour signaler plusieurs événements ou sur des événements qui se produisent fréquemment, envisagez de remplacer MessageBox.Show par Console.WriteLine ou d’ajouter le message à un TextBox multiligne.To report on multiple events or on events that occur frequently, consider replacing MessageBox.Show with Console.WriteLine or appending the message to a multiline TextBox.

Pour exécuter l’exemple de code, collez-le dans un projet qui contient une instance de type DataGridView nommée DataGridView1.To run the example code, paste it into a project that contains an instance of type DataGridView named DataGridView1. Assurez-vous ensuite que le gestionnaire d’événements est associé à l’événement RowHeightInfoNeeded.Then ensure that the event handler is associated with the RowHeightInfoNeeded event.

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

Remarques

Cet événement est utile pour conserver les hauteurs de lignes personnalisées après une opération de tri.This event is useful for preserving custom row heights after a sorting operation. Cela est nécessaire, car les opérations de tri sont normalement gérées par la source de données, ce qui ne fait pas le suivi de la correspondance entre les lignes de données et les lignes dans le contrôle.This is necessary because sorting operations are normally handled by the data source, which does not keep track of the correspondence between rows of data and rows in the control. Cet événement se produit uniquement lorsque la propriété DataSource a été définie ou lorsque la propriété VirtualMode est true.This event occurs only when the DataSource property has been set or when the VirtualMode property is true. Dans ce dernier cas, vous fournissez votre propre magasin de données et vos propres opérations de tri.In the latter case, you provide your own data store and sorting operations. Gérez l’événement RowHeightInfoPushed pour stocker les informations de hauteur mises à jour lorsque l’utilisateur modifie la hauteur d’une ligne.Handle the RowHeightInfoPushed event to store updated height information when the user changes a row height. Utilisez RowHeightInfoNeeded pour récupérer les informations de hauteur stockées lorsque le contrôle en a besoin.Use RowHeightInfoNeeded to retrieve the stored height information when the control needs it.

Pour plus d’informations sur la façon de gérer les événements, consultez gestion et déclenchement d’événements.For more information about how to handle events, see Handling and Raising Events.

S’applique à

Voir aussi