CellBeginEdit Event

Occurs when edit mode starts for the selected cell.

Syntax

Visual Basic (Declaration)
Visual Basic (Usage)
C#

<SRDescriptionAttribute("Occurs when edit mode starts for the selected cell.")>
<SRCategoryAttribute("Data")>
<FeatureAttribute(Name="UIEdit", Version="v5.0")>
Public Event CellBeginEdit As EventHandler(Of CellBeginEditEventArgs)

Dim instance As GcMultiRow
Dim handler As EventHandler(Of CellBeginEditEventArgs)
 
AddHandler instance.CellBeginEdit, handler

[SRDescription("Occurs when edit mode starts for the selected cell.")]
[SRCategory("Data")]
[Feature(Name="UIEdit", Version="v5.0")]
public event EventHandler<CellBeginEditEventArgs> CellBeginEdit

Event Data

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

Property	Description
BeginEditReason	Gets the BeginEditReason that specifies how a user starts cell editing in the GcMultiRow control.
Cancel	(Inherited from System.ComponentModel.CancelEventArgs)
CellIndex	Gets the cell index in its parent Section. (Inherited from GrapeCity.Win.MultiRow.CellCancelEventArgs)
CellName	Gets the cell name. (Inherited from GrapeCity.Win.MultiRow.CellCancelEventArgs)
MoveStatus	Gets the status that indicates which behavior caused the CellBeginEdit event to occur.
RowIndex	Gets the index of the owner Row that the event occurs for. (Inherited from GrapeCity.Win.MultiRow.CellCancelEventArgs)
Scope	Gets the cell area that the event occurs for. (Inherited from GrapeCity.Win.MultiRow.CellCancelEventArgs)
SectionIndex	Gets the index of the owner Section that the event occurs for. (Inherited from GrapeCity.Win.MultiRow.CellCancelEventArgs)

Remarks

The event order is as follows when the user edits a cell's value and then clicks another cell to apply the cell's value:

User double-clicks a cell or presses a shortcut key or presses a character to enter the edit state.
User inputs a value in the editing control or editing cell.
User clicks another cell and when the current cell prepares to move, the user can redirect the new cell position.
If the new target cell's row index is different from the old current cell's row index, the RowLeave event is fired.
Validates the cell's value.
Converts the editing value type to a cell acceptable value type.
The editing value is applied to the cell.
Validates the whole row's value when the new target cell's row index is different from the old current cell's row index.
The editing control or editing cell is uninstalled.
Enters a new target cell.

Requirements

Target Platforms: Windows 7, Windows Vista SP1 or later, Windows XP SP3, Windows Server 2008 (Server Core not supported), Windows Server 2008 R2 (Server Core supported with SP1 or later), Windows Server 2003 SP2

Reference

GcMultiRow Class
GcMultiRow Members