KarlKFI29989@legacy41550302 (talk | contribs) No edit summary |
SinusPi52472@legacy41571798 (talk | contribs) |
||
(6 intermediate revisions by 5 users not shown) | |||
Line 1: | Line 1: | ||
+ | <br>{{framexmlfunc|FrameXML/UIParent.lua}} __NOTOC__ |
||
− | <center>'''MouseIsOver''' ''-Documentation by [[user:coder_1024|coder_1024]]-''</center> |
||
⚫ | |||
Determines whether or not the mouse is over the specified frame. |
Determines whether or not the mouse is over the specified frame. |
||
⚫ | |||
− | ---- |
||
+ | |||
⚫ | |||
+ | |||
+ | == Parameters == |
||
⚫ | |||
:(frame, [topOffset, bottomOffset, leftOffset, rightOffset]) |
:(frame, [topOffset, bottomOffset, leftOffset, rightOffset]) |
||
+ | |||
− | :;frame : Frame - The frame 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 : (optional) Number - distance from the top to include in calculations |
||
:;bottomOffset : (optional) Number - distance from the bottom to include in calculations |
:;bottomOffset : (optional) Number - distance from the bottom to include in calculations |
||
Line 15: | Line 18: | ||
:;rightOffset : (optional) Number - distance from the right to include in calculations |
:;rightOffset : (optional) Number - distance from the right to include in calculations |
||
+ | === Returns === |
||
− | ---- |
||
− | ;''Results'' |
||
⚫ | |||
− | :isOver |
||
⚫ | |||
⚫ | |||
− | ---- |
||
⚫ | |||
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 29: | Line 29: | ||
-- do something |
-- do something |
||
end |
end |
||
+ | |||
− | ---- |
||
+ | |||
− | {{Template:WoW API}} |
||
+ | == Details == |
||
− | [[Category:API Frame Functions|MouseIsOver]] |
||
+ | : 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. |
Revision as of 23:52, 2 September 2009
- This function is implemented in
FrameXML/UIParent.lua
.
- This function is implemented in
Determines whether or not the mouse is over the specified frame.
isOver = MouseIsOver(frame, topOffset, bottomOffset, leftOffset, rightOffset);
Parameters
Arguments
- (frame, [topOffset, bottomOffset, leftOffset, rightOffset])
- 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
- bottomOffset
- (optional) Number - distance from the bottom to include in calculations
- leftOffset
- (optional) Number - distance from the left to include in calculations
- rightOffset
- (optional) Number - distance from the right to include in calculations
Returns
- isOver
- Boolean - A true value if the mouse is over the frame, false otherwise.
Example
You can determine whether or not the mouse is over the minimap using the below.
if (MouseIsOver(MinimapCluster)) then -- do something 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.
- 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.