AutoDragging Event, SftTree Object


	SftTree.AutoDragging Event	Softel vdm, Inc.

Dragging in progress (automatic DragMethod only).

Syntax

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

object

A SftTree object.

ItemIndex

The zero-based index where the current drop target is located. 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

Set to True to allow the item at ItemIndex to be a valid drop target, otherwise set to False. This value is passed to the AutoEndDragging event as Allowed parameter. This value has no effect on the current mouse pointer used. The mouse pointer must be modified using the MousePointer property.

Comments

The AutoDragging event occurs when dragging in progress (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.

The drop target (and any other tree control properties) cannot be modified during this event. It signals that the mouse cursor has moved and that the user is attempting to drag the currently selected item(s). You can override the MousePointer property in response to this event to provide visual feedback to the user.

The current drop target is displayed using the style defined using the Items.DropHighlightStyle property.