History of mouseOverWhenInvisible

== Syntax ==

:int mouseOverWhenInvisible (int t)

== Arguments ==

:t

::Set it to 0 to disable event triggering for disabled or invisible controls. Set it to 1 to enable event triggering for disabled or invisible controls.

== Return ==

:Always returns 1.

== Description ==

:By default FME_MOUSEOVER and FME_MOUSEOUT events are triggered even for disabled and invisible controls. This behaviour can be quite undesirable in some cases. So using mouseOverWhenInvisible(0) suppresses this behaviour and doesn't trigger any events for invisible or disabled controls. mouseOverWhenInvisible(1) activates the original behaviour again.

== Example ==

<code>

%ffp

ctl(0):statictext(mouseover),"Move the mouse pointer over me",size=(150,*), disable//invisible

ctl(4):checkbox,"mouseOverWhenInvisible", size=(100,*),val=1

onCtl(n):{

if (n==0)

Info ("Event was triggered");

if (n==4 && e==FME_CLICKED)

mouseOverWhenInvisible(ctl(4));

return false;

</code>

== Also see ==

:FME_MOUSEOVER, FME_MOUSEOUT

== Comments ==

:Everyone can add his comments about his experiences with this function here. Tips for using it are welcome, too.