mouseEnter

Typemessage
DictionaryLCS
LibraryLiveCode Script
Syntax
mouseEnter
Associationsstack, card, field, button, graphic, scrollbar, player, image
Summary

Sent when the mouse pointer moves into an object.

Introduced1.0
OSmac, windows, linux, ios, android
Platformsdesktop, server, mobile
Example
on mouseEnter -- show a Help field for the control the mouse is over
  show field (the short name of the target && "Help")
end mouseEnter
RelatedKeyword: control
Message: dragEnter, mouseLeave
Command: show
Function: mouseControl
Glossary: property, highlight, Browse tool, message, mouse pointer, command, object, loop
Object: button
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.

Tagsui