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

Occurs before a cell is deactivated.

Syntax

Visual Basic (Declaration) 
Public Event BeforeCellDeactivate As CancelEventHandler
C# 
public event CancelEventHandler BeforeCellDeactivate

Event Data

The event handler receives an argument of type CancelEventArgs containing data related to this event. The following CancelEventArgs properties provide information specific to this event.

PropertyDescription
Cancel Gets or sets a value indicating whether the event should be canceled.

Example

The following sample code illustrates how one can use combination of BeforeCellActivate and BeforeCellDeactivate to change the ActiveCell's appearance. ActiveCellAppearance property off the UltraGridOverride can be used to accomplish the same thing.

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_BeforeCellActivate(ByVal sender As Object, ByVal e As Infragistics.Win.UltraWinGrid.CancelableCellEventArgs) Handles ultraGrid1.BeforeCellActivate

      ' Set the appearance of the cell right before the cell is about to be activated.
      ' In the BeforeCellDeactivate, we will reset the BackColor.
      e.Cell.Appearance.BackColor = Color.LightYellow

  End Sub

  Private Sub UltraGrid1_BeforeCellDeactivate(ByVal sender As Object, ByVal e As System.ComponentModel.CancelEventArgs) Handles ultraGrid1.BeforeCellDeactivate

      ' Reset BackColor the appearance of the cell right before the cell is about
      ' to be deactivated.
      Me.ultraGrid1.ActiveCell.Appearance.ResetBackColor()

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

private void ultraGrid1_BeforeCellActivate(object sender, Infragistics.Win.UltraWinGrid.CancelableCellEventArgs e)
{

	// Set the appearance of the cell right before the cell is about to be activated.
	// In the BeforeCellDeactivate, we will reset the BackColor.
	e.Cell.Appearance.BackColor = Color.LightYellow;

}

private void ultraGrid1_BeforeCellDeactivate(object sender, System.ComponentModel.CancelEventArgs e)
{

	// Reset BackColor the appearance of the cell right before the cell is about
	// to be deactivated.
	this.ultraGrid1.ActiveCell.Appearance.ResetBackColor( );

}

Remarks

Thecancelargument enables you to programmatically prevent the the cell from deactivating, meaning it will not lose focus. This argument can be used to prevent the user from leaving the cell unless a certain condition is met.

This event is generated when the user attempts to move to a different cell, deactivating the original cell.

TheBeforeCellActivateevent is generated before a cell is activated, which means it will get focus.

TheActiveCellproperty can be used to determine which cell is currently active.

See Also