Occurs when you select and move an item up or down in a list box using the mouse, keyboard, or programmatically with the MoveItem method.
PROCEDURE OnMoveItem LPARAMETERS nSource, nShift, nCurrentIndex, nMoveBy |
Parameters
- nSource
-
Contains a number that specifies how the event is triggered.
nSource Description 0
Keyboard
1
Left mouse button
2
Right mouse button
4
Middle mouse button
8
Programmatically triggered by the MoveItem method
- nShift
-
Contains a number that specifies which modifier keys, SHIFT, CTRL, and ALT, are also pressed when the mouse button is pressed. The following table lists the values returned by nShift for individual modifier keys.
If more than one modifier key is held down when the mouse button is pressed, the nShift argument contains the sum of the values for the modifier keys. For example, if the user holds CTRL while pressing the mouse button, the nShift argument contains a value of 2. However, if the user holds down CTRL+ALT while pressing the mouse button, the nShift argument contains a value of 6.nShift Description 1
SHIFT
2
CTRL
4
ALT
- nCurrentIndex
- Contains the current index of the item being moved.
- nMoveBy
- Indicates how many positions the item is being moved. A positive value indicates downward movement. A negative number indicates upward movement. The nMoveBy parameter always has a value of 1 or -1 if the user is moving a list item using the keyboard. It usually has a value of 1 or -1 if the user is moving a list item using the mouse. However, nMoveBy indicates the position to which the item is moved if the user drags the mouse outside the bounds of the list box and then back to a remote position.
Remarks
Applies To: ListBox Control
OnMoveItem occurs after selecting and moving an item by pressing CTRL+UP ARROW, CTRL+DOWN ARROW or by using the mouse, or when calling the MoveItem method programmatically. OnMoveItem occurs after every subsequent move but before the list box displays the item movement. However, OnMoveItem occurs only once when calling the MoveItem method programmatically.
Note: |
---|
You can move ListBox control items only if the list box's RecordSourceType property is set to 0 (None) or 1 (Value). |
To prevent movement from occurring, return False (.F.) from the code in the OnMoveItem event.