INQ-DRAG-DROP Action

This document covers the following topics:


Description

Retrieves miscellaneous information relating to the current drag-drop operation.

This action should only be called if a drag-drop operation is in progress. Note that not all parameters are relevant and / or available for all drag events.

Parameters

Name/Data Type Explanation
HANDLE OF GUI Output (optional parameter)

The handle of the dialog containing the drop target, if available.

HANDLE OF GUI Output (optional parameter)

The drag source control's handle, if available.

Mode (I4) Output (optional parameter)

Indicates which augmentation keys are pressed. Possible values: 0 No key or information not available. 1 SHIFT key. 2 CTRL key. 3 Both SHIFT and CTRL keys

X-Position (I4) Output (optional parameter)

X-axis position on the target.

Y-Position (I4) Output (optional parameter)

Y-axis position on the target.

Buttons (I4) Output (optional parameter)

Indicates which mouse buttons are pressed. Possible values: 0 = No mouse button or information not available 1 = Left mouse button 2 = Right mouse button 4 = Middle mouse button. If multiple mouse buttons are pressed, the value returned is the sum of the individual values.

Drop Effect (I4) Output (optional parameter)

Indicates the type of drag-drop operation that occurred. Possible values: DM-NONE (0) = No drop, or information not available. DM-COPY (1) = Copy operation DM-MOVE (2) = Move operation DM-LINK (4) = Link operation

Response (I4) Output

Natural error (if applicable).

Example:

 
   PROCESS GUI ACTION INQ-DRAG-DROP WITH #DIA-HANDLE #DIA-ELEMENT #MODE 
   #X-POSITION #Y-POSITION GIVING #RESPONSE 
   #IF-1.STRING := #X-POSITION  /* Display the coordinates in these two 
   #IF-2.STRING := #Y-POSITION  /* Input Field Controls