AutoEndDragging Event, SftTree Object


	SftTree.AutoEndDragging Event	Softel vdm, Inc.

Dragging has ended (automatic DragMethod only).

Syntax

		VB.NET	Private Sub object_AutoEndDragging(ByVal sender As Object, ByVal e As EventArgumentType) Handles object.AutoEndDragging
		VB	Private Sub object_AutoEndDragging(ByVal ItemIndex As Long, ByVal Button As Integer, ByVal Shift As Integer, ByVal Allowed As Boolean)
		C#.NET	void object_AutoEndDragging(object sender, EventArgumentType e);
		VC++	void OnAutoEndDraggingobject(long ItemIndex, short Button, short Shift, VARIANT_BOOL Allowed);
		C	HRESULT OnAutoEndDraggingobject(long ItemIndex, short Button, short Shift, VARIANT_BOOL Allowed);
		Delphi	procedure objectAutoEndDragging(Sender: TObject; ItemIndex : Integer; Button : Smallint; Shift : Smallint; Allowed : WordBool);

object

A SftTree object.

ItemIndex

The zero-based index where the current drop target is located (see Items.DropHighlight or Items.Current). This value may be -1 if there is no current drop target.

Button

The button that is pressed during the event (see SftTreeButtonConstants). The button argument is a bit field with bits corresponding to the left button, right button and middle button. These bits correspond to the values shown below. Only one of the bits is set, indicating the button that caused the event.

Button	Value	Description
constSftTreeLeftButton	1	The left mouse button was pressed.
constSftTreeRightButton	2	The right mouse button was pressed.
constSftTreeMiddleButton	4	The middle mouse button was pressed.

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	The ALT key was pressed.

Allowed

Contains the value last set by the AutoDragging event.

Comments

The AutoEndDragging event occurs when dragging has ended (automatic DragMethod only).

This event is only available if the DragMethod property is set to dragSftTreeAuto and is suitable for drag & drop within one tree control only. If drag & drop between controls is desired, the container (i.e. Visual Basic, Visual C++, etc.) must implement the necessary drag & drop support (see DragMethod) or OLE drag & drop should be used instead.

This event signals that the user has dropped the selected item(s) at the item described by ItemIndex. The application can now move or copy items (using Items.Move or Items.Copy) as needed to reflect the drag & drop operation.

If the mouse pointer (MousePointer property) was modified during the AutoDragging event, the application must restore the original mouse pointer.