Sent when the mouse pointer moves into an object.
# Metadata
Platforms: desktop, server, mobile OS: mac, windows, linux, ios, android Introduced: 1.0 Security:
# Syntax
mouseEnter
# Examples
on mouseEnter -- show a Help field for the control the mouse is over show field (the short name of the target && "Help") end mouseEnter
# Description
Handle the mouseEnter message to perform an action (for example, display additional information or highlight a button) when the mouse pointer enters an object.
The mouseEnter message is sent only when the Browse tool is being used.
If two controls overlap, a mouseEnter message is sent whenever the mouse pointer crosses into a visible portion of a control. The control on the bottom receives a mouseEnter message only when the mouse pointer enters 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 mouseEnter message.
If the mouse button is down when the mouse pointer enters the control, the mouseEnter message is not sent unless the mouse button is released while the pointer is still in the control.
If a control is shown (by changing its visible property to true or using the show command), and the mouse pointer is over the control when it is shown, LiveCode sends a mouseEnter message to the control.
>*Note:* Take care when using both mouseEnter and mouseLeave in the > same control that an unintentional infinite loop may be invoked. > To prevent a loop, use a condition in the mouseLeave message handler > to ensure the mouse pointer is still outside of the control or > in the mouseEnter message to check the mouse pointer is still inside > the control.
# Tags
ui,
# See
- **keyword:** control - **message:** dragEnter, mouseLeave - **command:** show - **function:** mouseControl - **glossary:** property, highlight, Browse tool, message, mouse pointer, command, object, loop - **object:** button