Syntax 1: For ListView controls
Description
Occurs when the user presses the left mouse button in the ListView
control and begins dragging.
Event ID
|
Event ID |
Objects |
|---|---|
|
pbm_lvnbegindrag |
ListView |
Arguments
|
Argument |
Description |
|---|---|
|
index |
Integer by value (the index of the ListView item |
Return Values
Long.
Return code choices (specify in a RETURN statement):
0 — Continue processing
Usage
BeginDrag and BeginRightDrag events occur when the user presses
the mouse button and drags, whether or not dragging is enabled. To
enable dragging, you can:
-
Set the DragAuto property to true. If the ListView’s DragAuto
property is true, a drag operation begins automatically when the
user clicks. -
Call the Drag function. If DragAuto is false, then in the
BeginDrag event script, the programmer can call the Drag function to
begin the drag operation.
Dragging a ListView item onto another control causes its standard
drag events (DragDrop, DragEnter, DragLeave, and DragWithin) to occur.
The standard drag events occur for ListView when another control is
dragged within the borders of the ListView.
Examples
This example moves a ListView item from one ListView to another.
ilvi_dragged_object is a window instance variable whose type is
ListViewItem. To copy the item, omit the code that deletes it from the
source ListView.
This code is in the BeginDrag event script of the source
ListView:
|
1 2 3 4 5 6 7 8 9 |
// If the ListView's DragAuto property is FALSE This.Drag(Begin!) This.GetItem(This.SelectedIndex(), & ilvi_dragged_object) // To copy, rather than move, omit these two lines This.DeleteItem(This.SelectedIndex()) This.Arrange() |
This code is in the DragDrop event of the target ListView:
|
1 2 |
This.AddItem(ilvi_dragged_object) This.Arrange() |
See also