grab | |||||||
Type | command | ||||||
Dictionary | LCS | ||||||
Library | LiveCode Script | ||||||
Syntax |
| ||||||
Summary | Causes an object to follow the movements of the mouse. | ||||||
Introduced | 1.0 | ||||||
OS | mac, windows, linux, ios, android | ||||||
Platforms | desktop, server, mobile | ||||||
Parameters |
| ||||||
Example |
| ||||||
Related | Keyword: control Message: mouseDown, moveStack, mouseMove Command: click, drag, move Function: mouseLoc Glossary: object, handler, select, mouse pointer, command, stack window, execute | ||||||
Description | Use the grab command within a mouseDown handler to drag an object around the stack window without selecting it. You can only grab a control when the mouse pointer is within the control's rectangle at the time the mouse is clicked. If the mouse pointer is outside the control when the grab command is executed, nothing happens. Although the grab command returns to the calling handler immediately, the target control will remain grabbed until the user releases the mouse button, at which point the control will receive a mouseUp message. If a subsequent script action deletes the control, or if the control becomes invisible, the grab will be automatically cancelled and in this case no message will be sent to the control. | ||||||
Tags | ui |