SftBoxItems.DropIndex Property	Softel vdm, Inc.

Defines the drop target item.

Syntax       

	Get
		VB.NET	ItemIndex = object.DropIndex  As Integer
		VB	ItemIndex = object.DropIndex  As Long
		C#.NET	int ItemIndex = object.DropIndex;
		VC++	long ItemIndex = object->DropIndex; long ItemIndex = object->GetDropIndex();
		C	HRESULT object->get_DropIndex(long* ItemIndex);
		Delphi	ItemIndex := object.DropIndex   : Integer;
	Put
		VB.NET	object.DropIndex = ItemIndex  As Integer
		VB	object.DropIndex = ItemIndex  As Long
		C#.NET	int object.DropIndex = ItemIndex;
		VC++	long object->DropIndex = ItemIndex; void object->PutDropIndex(long ItemIndex);
		C	HRESULT object->put_DropIndex(long ItemIndex);
		Delphi	object.DropIndex := ItemIndex   : Integer;

object

A SftBoxItems object.

ItemIndex

The zero-based index of the item which acts as the current drop target.

Comments

The DropIndex property defines the drop target item.

The DropIndex property is typically used in the OLEDragDrop event to determine where data has been dropped, i.e. which item within the control is the drop target. The value of the DropIndex property is determined by the TargetIndex parameter of the OLEDragOver event.

The DropIndex property is used to highlight the target of a drag & drop operation. There can be only one drop target at any one time. By setting the DropIndex property to a new item, the previous item is no longer a drop target and is no longer highlighted.

The Items.DropHighlightStyle property can be used to control the appearance of the target item. Depending on the Items.DropHighlightStyle property value, the ItemIndex specified is the actual drop target or the insertion point. If used as an insertion point, the ItemIndex value can be set to the number of items in the control, which moves the insertion point to the end of the list of items.

By setting the DropIndex property to -1, the current drop target is cleared.

Based on the Items.DropScrolling property, if the DropIndex property is set to the first (or last) item currently visible in the drop down portion, the control automatically scrolls up (or down) one item. This allows a user to drag items to a target item which has to be scrolled into view first. The contents of the control will scroll in the given direction until the DropIndex property is set to -1 or to the index of an item which is not the first (or last) item visible.

If the DropIndex property is set to -1, the Items.DropScrolling property is automatically set to False.