DragAndDrop/en

Description

Alias: DAD

Drags an object to another object.

Uses the mouse to drag an object from the point specified by Reference1 relative to Bitmap1 to the point of Reference2 relative to Bitmap2 by using the Button. For moving, the status of shift keys can be set using the Key parameter. The number of clicks at the starting point is determined by the ClickCount parameter. To search for reference bitmaps, the maximum waiting time can be set using the Wait parameter, to skip multiple occurrences using the Skip1 or Skip2 parameters, and to mask the search by using the parameters MaskMode1, BitmapMaskColor1 and ScreenMaskColor1 or MaskMode2, BitmapMaskColor2 and ScreenMaskColor2). Search areas are specified by the values of the parameters CaptureMode1 and CaptureMode2. If none of the bitmaps is found, the command ends in error.

Input parameters

Bitmap1

Type Bitmap

Bitmap for the dragged object.

Reference1

Type Reference

Reference to the dragged object.

Bitmap2

Type Bitmap

Bitmap for the target object.

Reference2

Type Reference

Reference to the target object.

ClickCount

Type Number

Number of clicks at the point Reference1.

Button

Type Number

Specifies the mouse button used for clicking (0=none, 1=left, 2=right, 3=middle).

Key

Type Number

This parameter makes it possible to simulate the pressing of shift keys during dragging. A value of 0 means no shift keys, otherwise any combination of values can be used: 1=Shift, 2=Control, 4=Alt.

MaskMode1

Type Number

Mask mode used to search for Bitmap1 (0=none, 1=the user mask, 2=automatic mask).

BitmapMaskColor1

Type Color

Key color of the user mask in Bitmap1 (used only for MaskMode1=1).

ScreenMaskColor1

Type Color

Key color of the user mask on the captured screen, matching the color BitmapMaskColor1. You only need to set this value if two colors are different.

MaskMode2

Type Number

Mask mode used to search for Bitmap2 (0=none, 1=user mask, 2=automatic mask).

BitmapMaskColor2

Type Color

Key color of the user mask in Bitmap2 (used only for MaskMode2=1).

ScreenMaskColor2

Type Color

Key color of the user mask on the captured screen, matching the color BitmapMaskColor2. You only need to set this value if two colors are different.

Skip1

Type Number

Specifies the number of occurrences of Bitmap1 skipped during the search.

Skip2

Type Number

Specifies the number of occurrences of Bitmap2 skipped during the search.

Wait

Type Number

Waiting time in seconds for the bitmap to appear.

CaptureMode1

Type Number

Defines the search area of Bitmap1 (0=desktop, 1=active window, 2=active region, 3=active window area, 16=client part of the active window, 257-264=monitor 1-8, 512-520=active region 0-8).

CaptureMode2

Type Number

Defines the search area of Bitmap2 (0=desktop, 1=active window, 2=active region, 3=active window area, 16=client part of the active window, 257-264=monitor 1-8, 512-520=active region 0-8).

Enabled

Type Number

Enables or disables the command. If the value is 0, the command will not be executed.

PreWait

Type Number

Delay in milliseconds before executing the command. It has no effect if Enabled=0.

PostWait

Type Number

Delay in milliseconds before executing the command. It has no effect if Enabled=0.

See also

Examples of use

Using masks

Capture modes

Resolving multiple occurrences of the searched bitmap

Time limit and system parameters