DROP-MODE

#### Search Results

Search

# DROP-MODE

Indicates whether the dialog or dialog element can act as a drop target and, if so, which drag-drop operation types it supports.

The active drop target at any time during a drag-drop operation is the dialog or dialog element immediately under the drag cursor, if this is a drop target. Otherwise, it is the first ancestor control found (if any) when traversing up through the PARENT hierarchy that is a drop target (i.e., has a DROP-MODE attribute not equal to DM-NONE). The active drop target (if any) is the dialog or dialog element that receives the DRAG-ENTER, DRAG-OVER and DRAG-DROP events (if not suppressed).

The drag-drop operations available to the user at any time are determined by both the drag source's DRAG-MODE and the active drop target's DROP-MODE. Which of these available operations (if any) is used when a drop occurs and for determining which drag cursor is displayed to the user is determined by the augmentation keys held down whilst dragging. For example, the <ctrl> key forces a Copy operation (if available), whilst the <shift> and <ctrl> keys together force a Link operation (if available).

A Link operation implies that the source data is not moved or copied to the target. Instead, a reference to the source data is inserted at the target location. Thus, if the source data is changed, the link automatically refers to the changed data.

Note
The meaning of the word "reference" here is, in general, application-defined. However, in the case of the source data being a file or folder, it is conventionally a desktop shortcut.

Note that the symbolic drag mode constants listed below are defined in the local data area NGULKEY1, which is automatically used by all dialogs created within the dialog editor.

Applies to | ActiveX control, bitmap control, control box control, dialog (all types), edit area control, list box control, list view control, tree view control.
Data Type | I4
Default Value | DM-NONE (0)
Possible Values | DM-NONE (0) = Dialog or dialog element is not a drop target DM-COPY (1) = Copy operations supported DM-MOVE (2) = Move operations supported DM-COPYMOVE (3) = Copy and Move operations supported DM-LINK (4) = Link operations supported DM-COPYLINK (5) = Copy and Link operations supported DM-MOVELINK (6) = Move and Link operations supported DM-COPYMOVELINK (7) = Copy, Move and Link operations supported