EditNavigating Event, SftTree Object


	SftTree.EditNavigating Event	Softel vdm, Inc.

A key has been intercepted which is used for navigation during cell editing.

Syntax

		VB.NET	Private Sub object_EditNavigating(ByVal sender As Object, ByVal e As EventArgumentType) Handles object.EditNavigating
		VB	Private Sub object_EditNavigating(ByVal Key As Long, ByVal Shift As Integer, ByVal ItemIndex As Long, ByVal ColIndex As Integer)
		C#.NET	void object_EditNavigating(object sender, EventArgumentType e);
		VC++	void OnEditNavigatingobject(long Key, short Shift, long ItemIndex, short ColIndex);
		C	HRESULT OnEditNavigatingobject(long Key, short Shift, long ItemIndex, short ColIndex);
		Delphi	procedure objectEditNavigating(Sender: TObject; Key : Integer; Shift : Smallint; ItemIndex : Integer; ColIndex : Smallint);

object

A SftTree object.

Key

A virtual key code. Defines the key that was intercepted. See the CellEditIntercept method for a list of available virtual key codes.

Shift

The state of the SHIFT, CONTROL and ALT keys during the event (see SftTreeKeyConstants). A bit is set if the key is down. The Shift argument is a bit field with bits corresponding to the SHIFT, CONTROL and ALT keys. The Shift variable indicates the state of these keys. Some, all, or none of the bits can be set, indicating which of the keys are pressed.

Shift	Value	Description
constSftTreeShiftMask	1	The SHIFT key was pressed.
constSftTreeCtrlMask	2	The CONTROL key was pressed.
constSftTreeAltMask	4	Not used. The ALT key was pressed.

EditIndex

The zero-based index of the item being edited. The combination of EditIndex and EditCol describes an individual cell.

EditCol

The zero-based column number. The combination of EditIndex and EditCol describes an individual cell.

Comments

The EditNavigating event occurs when a key has been intercepted which is used for navigation during cell editing.

The CellEditIntercept method defines keystrokes to be intercepted during cell editing using the EditNavigating event. Only navigation keys should be intercepted. Other keys can be handled in the control's own event handlers (KeyDown/KeyPress/KeyUp events).

An application can handle a key by calling EndEdit to end cell editing of the current cell, followed by a call to Cell.Edit for the new cell to be edited.