EditInitializing Event, SftTree Object


	SftTree.EditInitializing Event	Softel vdm, Inc.

The control used for cell editing is initialized.

Syntax

		VB.NET	Private Sub object_EditInitializing(ByVal sender As Object, ByVal e As EventArgumentType) Handles object.EditInitializing
		VB	Private Sub object_EditInitializing(Window As OLE_HANDLE, vData As Variant, ByVal EditIndex As Long, ByVal EditCol As Integer, LeftPix As OLE_XPOS_PIXELS, TopPix As OLE_YPOS_PIXELS, WidthPix As OLE_XSIZE_PIXELS, HeightPix As OLE_YSIZE_PIXELS)
		C#.NET	void object_EditInitializing(object sender, EventArgumentType e);
		VC++	void OnEditInitializingobject(OLE_HANDLE* Window, const _variant_t&* vData, long EditIndex, short EditCol, OLE_XPOS_PIXELS* LeftPix, OLE_YPOS_PIXELS* TopPix, OLE_XSIZE_PIXELS* WidthPix, OLE_YSIZE_PIXELS* HeightPix);
		C	HRESULT OnEditInitializingobject(OLE_HANDLE* Window, VARIANT* vData, long EditIndex, short EditCol, OLE_XPOS_PIXELS* LeftPix, OLE_YPOS_PIXELS* TopPix, OLE_XSIZE_PIXELS* WidthPix, OLE_YSIZE_PIXELS* HeightPix);
		Delphi	procedure objectEditInitializing(Sender: TObject; var Window : Cardinal; var vData : OleVariant; EditIndex : Integer; EditCol : Smallint; var LeftPix : Integer; var TopPix : Integer; var WidthPix : OLE_XSIZE_PIXELS; var HeightPix : OLE_YSIZE_PIXELS);

object

A SftTree object.

Window

Returns the window handle of the control being used for cell editing. Initially, this argument contains the value passed as the Window argument of the Cell.Edit method.

vData

Returns application-specific data. Initially, this argument contains the application-specific data passed as the vData argument of the Cell.Edit method.

EditIndex

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

EditCol

The zero-based column number. The combination of ItemIndex and ColIndex describes an individual cell.

Left

Returns the coordinate of the desired left edge of the control used for cell editing. Initially, this argument contains the left edge of the cell to be edited. Coordinates are in pixels and relative to the top, left edge of the control's client area.

Top

Returns the coordinate of the desired top edge of the control used for cell editing. Initially, this argument contains the top edge of the cell to be edited. Coordinates are in pixels and relative to the top, left edge of the control's client area.

Width

Returns the desired width of the control used for cell editing. Initially, this argument contains width of the cell to be edited. Dimensions are in pixels.

Height

Returns the desired height of the control used for cell editing. Initially, this argument contains the height of the cell to be edited. Dimensions are in pixels.

Comments

The EditInitializing event occurs when the control used for cell editing is initialized.

The initializing event is used to make a control for cell editing available, by returning a control window handle (Window). The control's display attributes and contents should be fully initialized by this event. Its dimensions and position should be returned in the Left, Top, Width, Height arguments.

The control's position cannot be set in the EditInitializing event, instead the EditInitialized event is used. Only the width and height of the control can be updated in the EditInitializing event (or also in the EditInitialized event).

The CellEditIntercept method can be used to define navigational keys and other keystrokes that should be intercepted while cell editing. The EditNavigating event occurs when keystrokes are intercepted.