DataGridView.RowHeightInfoNeeded Event
Definition
Important
Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.
Occurs when information about row height is requested.
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 Event Type
Examples
The following code example demonstrates the use of this member. In the example, an event handler reports on the occurrence of the RowHeightInfoNeeded event. This report helps you to learn when the event occurs and can assist you in debugging. 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.
To run the example code, paste it into a project that contains an instance of type DataGridView named DataGridView1. 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
Remarks
This event is useful for preserving custom row heights after a sorting operation. 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. This event occurs only when the DataSource property has been set or when the VirtualMode property is true. In the latter case, you provide your own data store and sorting operations. Handle the RowHeightInfoPushed event to store updated height information when the user changes a row height. Use RowHeightInfoNeeded to retrieve the stored height information when the control needs it.
For more information about how to handle events, see Handling and Raising Events.
