dragLeave

Typemessage
DictionaryLCS
LibraryLiveCode Script
Syntax
dragLeave
Associationscard, field, button, graphic, scrollbar, player, image
Summary

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

Introduced2.0
OSmac, windows, linux
Platformsdesktop, server
Example
on dragLeave -- remove any outline around the drop no-longer-target
  set the borderColor of the target to empty
end dragLeave
RelatedGlossary: object, handler, control, mouse pointer, message, drag and drop
Message: dragEnter
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

Tagsui