dragLeave

Sent when the mouse pointer moves out of an object during a drag and drop.

# Metadata

Platforms: desktop, server OS: mac, windows, linux Introduced: 2.0 Security:

# Syntax

dragLeave

# Examples

on dragLeave -- remove any outline around the drop no-longer-target set the borderColor of the target to empty end dragLeave

# Description

Handle the dragLeave message to update a control when the mouse pointer moves outside it during drag and drop.

The dragLeave message is sent only when a drag and drop operation is in progress.

If two controls overlap, a dragLeave message is sent whenever the mouse pointer crosses outside a visible portion of a control. The control on the bottom receives a dragLeave message only when the mouse pointer leaves part of the control that can be seen. A control that is completely hidden by another control on top of it will never receive a dragLeave message.

You can use the dragEnter and dragLeave messages to display a visual cue that shows which control will receive the drop if the user releases the mouse button. For example, the following handlers turn the border of a "droppable" object green while the mouse is over it:

on dragEnter set the borderColor of the target to "green" end dragEnter

on dragLeave set the borderColor of the target to empty end dragLeave

# Tags

ui,

# See

- **glossary:** object, handler, control, mouse pointer, message, drag and drop - **message:** dragEnter