WoW:API MouseIsOver: Difference between revisions

m
Move page script moved page API MouseIsOver to WoW:API MouseIsOver without leaving a redirect
m (Move page script moved page API MouseIsOver to WoW:API MouseIsOver without leaving a redirect)
 
(One intermediate revision by one other user not shown)
Line 1: Line 1:
<br>{{framexmlfunc|FrameXML/UIParent.lua}} __NOTOC__
{{framexmlfunc|FrameXML/UIParent.lua}}
 
 
Determines whether or not the mouse is over the specified frame.
Determines whether or not the mouse is over the specified frame.


  isOver = MouseIsOver(frame, topOffset, bottomOffset, leftOffset, rightOffset);
  isOver = MouseIsOver(frame, topOffset, bottomOffset, leftOffset, rightOffset);


== Parameters ==
== Parameters ==
=== Arguments ===
=== Arguments ===
:(frame, [topOffset, bottomOffset, leftOffset, rightOffset])
:(frame, [topOffset, bottomOffset, leftOffset, rightOffset])


:;frame : Frame - The frame (or frame-derived object such as Buttons, etc) to test with
* frame (Frame) - The frame (or frame-derived object such as Buttons, etc) to test with
:;topOffset : (optional) Number - distance from the top to include in calculations
* topOffset (number) - distance from the top to include in calculations. optional
:;bottomOffset : (optional) Number - distance from the bottom to include in calculations
* bottomOffset (number) - distance from the bottom to include in calculations. optional
:;leftOffset : (optional) Number - distance from the left to include in calculations
* leftOffset (number) - distance from the left to include in calculations. optional
:;rightOffset : (optional) Number - distance from the right to include in calculations
* rightOffset (number) - distance from the right to include in calculations. optional


=== Returns ===
=== Returns ===


:;isOver : [[Boolean]] - A <tt>true</tt> value if the mouse is over the frame, <tt>false</tt> otherwise.
* isOver ([[boolean]]) - A 'true' value if the mouse is over the frame, 'false<' otherwise.


== Example ==
== Example ==
You can determine whether or not the mouse is over the minimap using the below.
You can determine whether or not the mouse is over the minimap using the below.


Line 30: Line 25:
  end
  end


== Details ==
It doesn't matter if the frame is hidden or not, if the mouse would be over it when you :Show() it then this function does return true.


== Details ==
Most importantly, it will still return true if the frame in question has its mouse response disabled using EnableMouse(false). Hence, ''MouseIsOver'' is what you need for rollover effects not interfering with the player's world clicks.
: It doesn't matter if the frame is hidden or not, if the mouse would be over it when you :Show() it then this function does return true.
: Most importantly, it will still return true if the frame in question has its mouse response disabled using EnableMouse(false). Hence, ''MouseIsOver'' is what you need for rollover effects not interfering with the player's world clicks.
Anonymous user