lockCursor | |||||||
Type | property | ||||||
Dictionary | LCS | ||||||
Library | LiveCode Script | ||||||
Syntax |
| ||||||
Summary | Specifies whether the cursor shape changes depending on the current tool and what the mouse pointer is over. | ||||||
Introduced | 1.0 | ||||||
OS | mac, windows, linux | ||||||
Platforms | desktop, server | ||||||
Example |
| ||||||
Values |
| ||||||
Related | Property: cursor, defaultCursor, lockLocation, lockScreen Message: mouseEnter, mouseLeave Keyword: field, menu Glossary: property, handler, mouse pointer, exit, lock Function: tool Command: unlock cursor, lock cursor Object: field, stack | ||||||
Description | Use the lockCursor property to set a custom cursor that persists after the handler exits. If the lockCursor property is set to true, the cursor shape can be set only by a handler, and does not change shape automatically as the mouse moves. (For example, the cursor normally turns into an arrow over a menu, an I-beam over an editable field, and so on.) If the lockCursor is false, the cursor automatically changes shape according to its location. For example, to set a custom cursor while the mouse pointer is over a certain field, set the lockCursor to true and then set the cursor to the desired shape in a mouseEnter handler. In the field's mouseLeave handler, set the lockCursor to false to allow the cursor to automatically change shape.
| ||||||
Tags | ui |