BeforeColUpdateEventHandler Delegate

Raised after editing is completed in a cell.

[Visual Basic]

Public Delegate Sub BeforeColUpdateEventHandler( _

ByVal sender As Object, _

ByVal e As BeforeColUpdateEventArgs _

)

[C#]

public delegate void BeforeColUpdateEventHandler(

object sender,

BeforeColUpdateEventArgs e

);

[Delphi]

type BeforeColUpdateEventHandler = procedure (

sender: Object;

e: BeforeColUpdateEventArgs

) of object;

Namespace: C1.Win.C1TrueDBGrid

Assembly: C1.Win.C1TrueDBGrid.2 (in C1.Win.C1TrueDBGrid.2.dll)

Remarks

The C1TrueDBGrid.BeforeColUpdate event occurs after editing is completed in a cell, but before data is moved from the cell to the grid's internal copy buffer.

The data specified by the BeforeColUpdateEventArgs.OldValue property moves from the cell to the grid's copy buffer when the user completes editing within a cell, as when tabbing to another column in the same row, pressing the ENTER key, or clicking on another cell. Before the data has been moved from the cell into the grid's copy buffer, the C1TrueDBGrid.BeforeColUpdate event is triggered. This event gives the application an opportunity to check the individual grid cells before they are committed to the grid's copy buffer.

If your event procedure sets the BeforeColUpdateEventArgs.Cancel property to True, the previous value is restored in the cell, the grid retains focus, and the C1TrueDBGrid.AfterColUpdate event is not triggered. Change the current cell text by setting BeforeColUpdateEventArgs.OldValue to the desired display value (other than the previous value).