Infragistics(R) NetAdvantage(R) Windows Forms
BeforeRowRegionSplitEventArgs Class
Members  Example  See Also  E-mail your feedback on this topic.
Infragistics.Win.UltraWinGrid Namespace : BeforeRowRegionSplitEventArgs Class

Event parameters used for the BeforeRowRegionSplit event

Syntax

Visual Basic (Declaration) 
Public Class BeforeRowRegionSplitEventArgs 
   Inherits System.ComponentModel.CancelEventArgs
C# 
public class BeforeRowRegionSplitEventArgs : System.ComponentModel.CancelEventArgs 

Example

Following code illustrates how you can use combination of BeforeRowRegionSplit and BeforeRowRegionSize events to prevent the user from resizing any of the row scroll regions too small. BeforeRowRegionSize event gets fired when the user resizes any of the existing row scroll regions and BeforeRowRegionSplit gets fired when the user splits a row scroll region.

For an overview of how to handle events in Visual Basic or Visual C#, see Event Handlers in Visual Basic and Visual C#. For specific information and code examples illustrating how to consume events in your application, see Consuming Events in the .NET Framework Developer's Guide.

Visual BasicCopy Code
Imports Infragistics.Shared
Imports Infragistics.Win
Imports Infragistics.Win.UltraWinGrid

  Private Sub UltraGrid1_BeforeRowRegionSplit(ByVal sender As Object, ByVal e As Infragistics.Win.UltraWinGrid.BeforeRowRegionSplitEventArgs) Handles ultraGrid1.BeforeRowRegionSplit

      ' If the new scroll region is smaller than 50 pixels, then cancel the event
      ' so the UltraGrid doesn't proceed with the region split.
      If e.NewRowScrollRegion.Height < 50 Then
          e.Cancel = True

          ' Also cancel if the row scroll region being split would end up being less
          ' than 50 pixels as a result of the split.
      ElseIf e.OriginalRowScrollRegion.Height - e.NewRowScrollRegion.Height < 50 Then
          e.Cancel = True
      End If

      If e.Cancel Then
          MessageBox.Show("You cannot split a row scroll region smaller than 50 pixels.")
      End If

  End Sub

  Private Sub UltraGrid1_BeforeRowRegionSize(ByVal sender As Object, ByVal e As Infragistics.Win.UltraWinGrid.BeforeRowRegionSizeEventArgs) Handles ultraGrid1.BeforeRowRegionSize

      ' If the user resizes a scroll region in such a way so that any of the
      ' effected scroll regions ends up being less than 50, then cancel it.			
      If e.Region1.Height < 50 Or e.Region2.Height < 50 Then
          e.Cancel = True
          MessageBox.Show("You cannot resize a row scroll region smaller than 50 pixels.")
      End If

  End Sub
C#Copy Code
using Infragistics.Shared;
using Infragistics.Win;
using Infragistics.Win.UltraWinGrid;
using System.Diagnostics;

private void ultraGrid1_BeforeRowRegionSplit(object sender, Infragistics.Win.UltraWinGrid.BeforeRowRegionSplitEventArgs e)
{

	// If the new scroll region is smaller than 50 pixels, then cancel the event
	// so the UltraGrid doesn't proceed with the region split.
	if ( e.NewRowScrollRegion.Height < 50 )
		e.Cancel = true;

	// Also cancel if the row scroll region being split would end up being less
	// than 50 pixels as a result of the split.
	else if ( e.OriginalRowScrollRegion.Height - e.NewRowScrollRegion.Height < 50 )
		e.Cancel = true;

	if ( e.Cancel )
	{
		MessageBox.Show( "You cannot split a row scroll region smaller than 50 pixels." );
	}

}

private void ultraGrid1_BeforeRowRegionSize(object sender, Infragistics.Win.UltraWinGrid.BeforeRowRegionSizeEventArgs e)
{

	// If the user resizes a scroll region in such a way so that any of the
	// effected scroll regions ends up being less than 50, then cancel it.			
	if ( e.Region1.Height < 50 || e.Region2.Height < 50 )
	{
		e.Cancel = true;

		MessageBox.Show( "You cannot resize a row scroll region smaller than 50 pixels." );
	}

}

See Also