Widget API: Region:GetPoint

Revision as of 22:21, 17 January 2015 by Bear (talk | contribs)

Widget API ← Region < GetPoint

Returns information about the anchor points for a region.

point, relativeTo, relativePoint, xOfs, yOfs = MyRegion:GetPoint(n)

Parameters

Arguments

n
integer - number of point about which you want to retrieve info. Should be in range 1 .. MyRegion:GetNumPoints()

Returns

point
FramePoint -- attachment point of frame MyFrame
relativeTo
Region -- The frame MyFrame is attached to (NOTE: this returns the actual widget object, if you want to get that object's name, use relativeTo:GetName())
relativePoint
FramePoint -- attachment point of the relativeTo frame
xOfs
number -- horizontal offset; not necessarily integer (positive xOfs means shift to the right)
yOfs
number -- vertical offset; not necessarily integer (positive yOfs means shift upwards)

Example

point, relativeTo, relativePoint, xOfs, yOfs = MyAddon_Frame1:GetPoint()
DEFAULT_CHAT_FRAME:AddMessage(point)
DEFAULT_CHAT_FRAME:AddMessage(relativeTo:GetName())
DEFAULT_CHAT_FRAME:AddMessage(relativePoint)
DEFAULT_CHAT_FRAME:AddMessage(xOfs)
DEFAULT_CHAT_FRAME:AddMessage(yOfs)

Result:

TOP
MyAddon_Frame0
BOTTOM
0
-10

Notes

  • As of 2.2 the screen coordinates are no longer relative to the TOPLEFT instead they are relative to closest screen position which can be TOPLEFT, TOP, TOPRIGHT, LEFT, CENTER, RIGHT, BOTTOMLEFT, BOTTOM and BOTTOMRIGHT be sure to use/save the relativePoint argument in addition to xOfs and yOfs for frame positioning or your frames will appear at the wrong place and even off the screen.