When-Mouse-Enter Trigger
Description
Fires when the mouse enters an item or canvas if one of the following events occurs:
- if attached to the form, when the mouse enters any canvas or item in the
form
- if attached to a block, when the mouse enters any item in the block
- if attached to an item, when the mouse enters the item
Definition Level form, block, or item
Legal Commands
SELECT statements, restricted Built-ins, unrestricted Built-ins
Enter Query Mode yes
Usage Notes
- Use a When-Mouse-Enter trigger to perform an action every time the mouse
enters an item or canvas.
- Do not use the When-Mouse-Enter trigger on a canvas that is larger than
the window. Iconic buttons and items on the canvas below the initial window
cannot be selected. The user is able to scroll the canvas to see the items.
However, as soon as the mouse enters that area, the trigger fires and returns
focus to the previous target, so the user is never able to click on those
items.
- Changing a tooltip's property in a When-Mouse-Enter trigger cancels the
tooltip before it is ever shown.
- Be careful when calling a modal window from a When-Mouse-Enter trigger.
Doing so may cause the modal window to appear unnecessarily.
- For example, assume that your When-Mouse-Enter trigger causes Alert_One
to appear whenever the mouse enters Canvas_One. Assume also that your application
contains two canvases, Canvas_One and Canvas_Two. Canvas_One and Canvas_Two
do not overlap each other, but appear side by side on the screen. Further,
assume that Alert_One displays within Canvas_Two's border.
- Finally, assume that the mouse has entered Canvas_One causing the When-Mouse-Enter
trigger to fire which in turn causes Alert_One to appear.
- When the operator dismisses the message box, Alert_One will appear again
unnecessarily if the operator subsequently enters Canvas_One with
the mouse. In addition, when the operator moves the mouse out of Canvas_Two,
any When-Mouse-Leave triggers associated with
this event will fire. This may not be the desired behavior.
On Failure
no effect