Back to index...

NameTypeDeprecatedSecureDescription
TextureA UI element of type Texture or derived from Texture.
Texture.Event:KeyDownSignals a key pressed.
Texture.Event:KeyFocusGainSignals gaining key focus.
Texture.Event:KeyFocusLossSignals losing key focus.
Texture.Event:KeyRepeatFrame.Event:KeyRepeat@summary
Texture.Event:KeyTypeSignals text typed.
Texture.Event:KeyUpSignals a key released.
Texture.Event:LayerSignals a change in the item's layer.
Texture.Event:LeftClickSignals that the mouse's left button has been clicked inside the frame. Blocks left mouse events ...
Texture.Event:LeftDownSignals that the mouse's left button has been pressed inside the frame. Blocks left mouse events ...
Texture.Event:LeftUpSignals that the mouse's left button has been released inside the frame. Blocks left mouse events...
Texture.Event:LeftUpoutsideSignals that the mouse's left button has been released outside the frame, after a "Down" message....
Texture.Event:MiddleClickSignals that the mouse's middle button has been clicked inside the frame. Blocks middle mouse eve...
Texture.Event:MiddleDownSignals that the mouse's middle button has been pressed inside the frame. Blocks middle mouse eve...
Texture.Event:MiddleUpSignals that the mouse's middle button has been released inside the frame. Blocks middle mouse ev...
Texture.Event:MiddleUpoutsideSignals that the mouse's middle button has been released outside the frame, after a "Down" messag...
Texture.Event:Mouse4ClickSignals that the mouse's fourth button has been clicked inside the frame. Blocks fourth button mo...
Texture.Event:Mouse4DownSignals that the mouse's fourth button has been pressed inside the frame. Blocks fourth button mo...
Texture.Event:Mouse4UpSignals that the mouse's fourth button has been released inside the frame. Blocks fourth button m...
Texture.Event:Mouse4UpoutsideSignals that the mouse's fourth button has been released outside the frame, after a "Down" messag...
Texture.Event:Mouse5ClickSignals that the mouse's fifth button has been clicked inside the frame. Blocks fifth button mous...
Texture.Event:Mouse5DownSignals that the mouse's fifth button has been pressed inside the frame. Blocks fifth button mous...
Texture.Event:Mouse5UpSignals that the mouse's fifth button has been released inside the frame. Blocks fifth button mou...
Texture.Event:Mouse5UpoutsideSignals that the mouse's fifth button has been released outside the frame, after a "Down" message...
Texture.Event:MouseInSignals that the mouse cursor has been moved onto the frame. Blocks mouse movement events from fr...
Texture.Event:MouseMoveSignals that the mouse cursor has been moved within the frame. Blocks mouse movement events from ...
Texture.Event:MouseOutSignals that the mouse cursor has been moved off of the frame. Blocks mouse movement events from ...
Texture.Event:MoveSignals that the frame's vertices have moved.
Texture.Event:RightClickSignals that the mouse's right button has been clicked inside the frame. Blocks right mouse event...
Texture.Event:RightDownSignals that the mouse's right button has been pressed inside the frame. Blocks right mouse event...
Texture.Event:RightUpSignals that the mouse's right button has been released inside the frame. Blocks right mouse even...
Texture.Event:RightUpoutsideSignals that the mouse's right button has been released outside the frame, after a "Down" message...
Texture.Event:SizeSignals that the frame's size has changed.
Texture.Event:StrataSignals a change in the item's strata.
Texture.Event:WheelBackSignals that the mousewheel has been moved backward inside the frame. Blocks mousewheel events fr...
Texture.Event:WheelForwardSignals that the mousewheel has been moved forward inside the frame. Blocks mousewheel events fro...
Texture:ClearAllfunctionClear all set points and sizes from this frame.
Texture:ClearHeightfunctionClear a set height from this frame.
Texture:ClearPointfunctionClear a set point from this frame.
Texture:ClearWidthfunctionClear a set width from this frame.
Texture:EventAttachfunctionAttaches an event handler to an event.
Texture:EventDetachfunctionDetaches an event handler from an event. Any parameter can be 'nil', and this is interpreted as a...
Texture:EventListfunctionLists the current event handlers for an event.
Texture:EventMacroGetfunctionGets the macro that will be triggered when this event occurs.
Texture:EventMacroSetfunctionSets the macro that will be triggered when this event occurs.
Texture:GetAlphafunctionGets the alpha multiplier of this frame.
Texture:GetBackgroundColorfunctionRetrieves the background color of this frame.
Texture:GetBottomfunctionRetrieves the Y position of the bottom edge of this element.
Texture:GetBoundsfunctionRetrieves the complete bounds of this element.
Texture:GetChildrenfunctionReturns a table containing all of this element's children.
Texture:GetEventTablefunctionRetrieves the event table of this element. By default, this value is also stored in "this.Event".
Texture:GetHeightfunctionRetrieves the height of this element.
Texture:GetKeyFocusfunctionGets the key focus status.
Texture:GetLayerfunctionGets the frame's layer order.
Texture:GetLeftfunctionRetrieves the X position of the left edge of this element.
Texture:GetMouseMaskingfunctionGet the current mouse masking mode. See SetMouseMasking for details.
Texture:GetMouseoverUnitfunctionGets the unit that is being represented by this frame.
Texture:GetNamefunctionRetrieves the name of this element.
Texture:GetOwnerfunctionRetrieves the owner of this element.
Texture:GetParentfunctionGets the parent of this frame.
Texture:GetRightfunctionRetrieves the X position of the right edge of this element.
Texture:GetSecureModefunctionGet the current secure mode. See SetSecureMode for details.
Texture:GetStratafunctionGets the frame's strata. The strata determines render order on a coarser level than Layer does, a...
Texture:GetStrataListfunctionGets a list of valid stratas for this frame.
Texture:GetTexturefunctionGets the current texture used for this element.
Texture:GetTextureHeightfunctionReturns the actual pixel height of the current texture.
Texture:GetTextureWidthfunctionReturns the actual pixel width of the current texture.
Texture:GetTopfunctionRetrieves the Y position of the top edge of this element.
Texture:GetTypefunctionRetrieves the type of this element.
Texture:GetVisiblefunctionGets the visibility flag for this frame.
Texture:GetWidthfunctionRetrieves the width of this element.
Texture:ReadAllfunctionRead all set points and sizes from this frame.
Texture:ReadHeightfunctionRead a set height from this frame.
Texture:ReadPointfunctionRead a set point from this frame. Must be given a single-axis coordinate.
Texture:ReadWidthfunctionRead a set width from this frame.
Texture:SetAllPointsfunctionPins all the edges of this frame to the edges of a different frame. If no target is given, defaul...
Texture:SetAlphafunctionSets the alpha transparency multiplier for this frame and its children.
Texture:SetBackgroundColorfunctionSets the background color of this frame.
Texture:SetHeightfunctionSets the height of this frame. Undefined results if the frame already has two pinned Y coordinates.
Texture:SetKeyFocusfunctionSets the key focus status. Note that only one frame can be the key focus at a time. Focusing on a...
Texture:SetLayerfunctionSets the frame layer for this frame. This can be any number. Frames are drawn in ascending order....
Texture:SetMouseMaskingfunctionSets the frame's mouse masking mode.
Texture:SetMouseoverUnitfunctionSets the unit that will be represented by this frame.
Texture:SetParentfunctionSets the parent of this frame. Circular dependencies result in undefined behavior. If this frame'...
Texture:SetPointfunctionPins a point on this frame to a location on another frame. This is a rather complex function and ...
Texture:SetSecureModefunctionSets the frame's secure mode.
"normal" is the standard mode. It allows for most functionality to ...
Texture:SetStratafunctionSets the strata for this frame.
Texture:SetTexturefunctionSets the current texture used for this element.
Texture:SetVisiblefunctionSets the frame's visibility flag. If set to false, then this frame and all its children will not ...
Texture:SetWidthfunctionSets the width of this frame. Undefined results if the frame already has two pinned X coordinates.

Texture

A UI element of type Texture or derived from Texture.

Texture.Event:KeyDown

Signals a key pressed.

Usage:

Frame.Event:KeyDown(button)
ParameterTypeDatatypeDescription
buttonparametervariantThe key, in string form.

Texture.Event:KeyFocusGain

Signals gaining key focus.

Usage:

Frame.Event:KeyFocusGain()

Texture.Event:KeyFocusLoss

Signals losing key focus.

Usage:

Frame.Event:KeyFocusLoss()

Texture.Event:KeyRepeat

Frame.Event:KeyRepeat@summary

Usage:

Frame.Event:KeyRepeat(button)
ParameterTypeDatatypeDescription
buttonparametervariantThe key, in string form.

Texture.Event:KeyType

Signals text typed.

Usage:

Frame.Event:KeyType(typed)
ParameterTypeDatatypeDescription
typedparametervariantThe text.

Texture.Event:KeyUp

Signals a key released.

Usage:

Frame.Event:KeyUp(button)
ParameterTypeDatatypeDescription
buttonparametervariantThe key, in string form.

Texture.Event:Layer

Signals a change in the item's layer.

Usage:

Frame.Event:Layer()

Texture.Event:LeftClick

Signals that the mouse's left button has been clicked inside the frame. Blocks left mouse events and mouse movement events from frames below this one. May block right mouse events depending on the MouseMasking mode.

Usage:

Frame.Event:LeftClick()

Texture.Event:LeftDown

Signals that the mouse's left button has been pressed inside the frame. Blocks left mouse events and mouse movement events from frames below this one. May block right mouse events depending on the MouseMasking mode.

Usage:

Frame.Event:LeftDown()

Texture.Event:LeftUp

Signals that the mouse's left button has been released inside the frame. Blocks left mouse events and mouse movement events from frames below this one. May block right mouse events depending on the MouseMasking mode.

Usage:

Frame.Event:LeftUp()

Texture.Event:LeftUpoutside

Signals that the mouse's left button has been released outside the frame, after a "Down" message. Blocks left mouse events and mouse movement events from frames below this one. May block right mouse events depending on the MouseMasking mode.

Usage:

Frame.Event:LeftUpoutside()

Texture.Event:MiddleClick

Signals that the mouse's middle button has been clicked inside the frame. Blocks middle mouse events from frames below this one.

Usage:

Frame.Event:MiddleClick()

Texture.Event:MiddleDown

Signals that the mouse's middle button has been pressed inside the frame. Blocks middle mouse events from frames below this one.

Usage:

Frame.Event:MiddleDown()

Texture.Event:MiddleUp

Signals that the mouse's middle button has been released inside the frame. Blocks middle mouse events from frames below this one.

Usage:

Frame.Event:MiddleUp()

Texture.Event:MiddleUpoutside

Signals that the mouse's middle button has been released outside the frame, after a "Down" message. Blocks middle mouse events from frames below this one.

Usage:

Frame.Event:MiddleUpoutside()

Texture.Event:Mouse4Click

Signals that the mouse's fourth button has been clicked inside the frame. Blocks fourth button mouse events from frames below this one.

Usage:

Frame.Event:Mouse4Click()

Texture.Event:Mouse4Down

Signals that the mouse's fourth button has been pressed inside the frame. Blocks fourth button mouse events from frames below this one.

Usage:

Frame.Event:Mouse4Down()

Texture.Event:Mouse4Up

Signals that the mouse's fourth button has been released inside the frame. Blocks fourth button mouse events from frames below this one.

Usage:

Frame.Event:Mouse4Up()

Texture.Event:Mouse4Upoutside

Signals that the mouse's fourth button has been released outside the frame, after a "Down" message. Blocks fourth button mouse events from frames below this one.

Usage:

Frame.Event:Mouse4Upoutside()

Texture.Event:Mouse5Click

Signals that the mouse's fifth button has been clicked inside the frame. Blocks fifth button mouse events from frames below this one.

Usage:

Frame.Event:Mouse5Click()

Texture.Event:Mouse5Down

Signals that the mouse's fifth button has been pressed inside the frame. Blocks fifth button mouse events from frames below this one.

Usage:

Frame.Event:Mouse5Down()

Texture.Event:Mouse5Up

Signals that the mouse's fifth button has been released inside the frame. Blocks fifth button mouse events from frames below this one.

Usage:

Frame.Event:Mouse5Up()

Texture.Event:Mouse5Upoutside

Signals that the mouse's fifth button has been released outside the frame, after a "Down" message. Blocks fifth button mouse events from frames below this one.

Usage:

Frame.Event:Mouse5Upoutside()

Texture.Event:MouseIn

Signals that the mouse cursor has been moved onto the frame. Blocks mouse movement events from frames below this one. May block left and right events depending on the MouseMasking mode.

Usage:

Frame.Event:MouseIn()

Texture.Event:MouseMove

Signals that the mouse cursor has been moved within the frame. Blocks mouse movement events from frames below this one. May block left and right events depending on the MouseMasking mode.

Usage:

Frame.Event:MouseMove(x, y)
ParameterTypeDatatypeDescription
xparametervariantX coordinate.
yparameter<nope>Y coordinate.

Texture.Event:MouseOut

Signals that the mouse cursor has been moved off of the frame. Blocks mouse movement events from frames below this one. May block left and right events depending on the MouseMasking mode.

Usage:

Frame.Event:MouseOut()

Texture.Event:Move

Signals that the frame's vertices have moved.

Usage:

Layout.Event:Move()

Texture.Event:RightClick

Signals that the mouse's right button has been clicked inside the frame. Blocks right mouse events and mouse movement events from frames below this one. May block left mouse events depending on the MouseMasking mode.

Usage:

Frame.Event:RightClick()

Texture.Event:RightDown

Signals that the mouse's right button has been pressed inside the frame. Blocks right mouse events and mouse movement events from frames below this one. May block left mouse events depending on the MouseMasking mode.

Usage:

Frame.Event:RightDown()

Texture.Event:RightUp

Signals that the mouse's right button has been released inside the frame. Blocks right mouse events and mouse movement events from frames below this one. May block left mouse events depending on the MouseMasking mode.

Usage:

Frame.Event:RightUp()

Texture.Event:RightUpoutside

Signals that the mouse's right button has been released outside the frame, after a "Down" message. Blocks right mouse events and mouse movement events from frames below this one. May block left mouse events depending on the MouseMasking mode.

Usage:

Frame.Event:RightUpoutside()

Texture.Event:Size

Signals that the frame's size has changed.

Usage:

Layout.Event:Size()

Texture.Event:Strata

Signals a change in the item's strata.

Usage:

Frame.Event:Strata()

Texture.Event:WheelBack

Signals that the mousewheel has been moved backward inside the frame. Blocks mousewheel events from frames below this one.

Usage:

Frame.Event:WheelBack()

Texture.Event:WheelForward

Signals that the mousewheel has been moved forward inside the frame. Blocks mousewheel events from frames below this one.

Usage:

Frame.Event:WheelForward()

Texture:ClearAll

Clear all set points and sizes from this frame.

Usage:

Frame:ClearAll()
noSecureFrameAndEnvironment
true

Texture:ClearHeight

Clear a set height from this frame.

Usage:

Frame:ClearHeight()
noSecureFrameAndEnvironment
true

Texture:ClearPoint

Clear a set point from this frame.

Usage:

Frame:ClearPoint(coordinate)
Frame:ClearPoint(x, y)
ParameterTypeDatatypeDescription
coordinateparameterstringNamed coordinate.
xparameternumber/nilX coordinate of the point.
yparameternumber/nilY coordinate of the point.
noSecureFrameAndEnvironment
true

Texture:ClearWidth

Clear a set width from this frame.

Usage:

Frame:ClearWidth()
noSecureFrameAndEnvironment
true

Texture:EventAttach

Attaches an event handler to an event.

Usage:

Layout:EventAttach(handle, callback, label)
Layout:EventAttach(handle, callback, label, priority)
ParameterTypeDatatypeDescription
callbackparameterfunctionA global event handler function. This will be called when the event fires. The first parameter will be the frame that the event is called on, the second parameter will be the standard frame event handle, any other parameters will follow that.
handleparametereventFrameA handle to a frame event, usually pulled out of the "Event.UI." hierarchy.
labelparameterstringHuman-readable label used to identify the handler in error reports, performance reports, and for later detaching.
priorityparameternumberPriority of the event handler. Higher numbers trigger first.
noSecureFrameAndEnvironment
true

Texture:EventDetach

Detaches an event handler from an event. Any parameter can be 'nil', and this is interpreted as a wildcard. If multiple events match the constraints, only one will be detached.

Usage:

Layout:EventDetach(handle, callback)
Layout:EventDetach(handle, callback, label)
Layout:EventDetach(handle, callback, label, priority)
Layout:EventDetach(handle, callback, label, priority, owner)
ParameterTypeDatatypeDescription
callbackparameterfunction/nilA callback function to search for.
handleparametereventFrameA handle to a frame event, usually pulled out of the "Event.UI." hierarchy.
labelparameterstring/nilHuman-readable label used to identify the handler in error reports, performance reports, and for later detaching.
ownerparameterstring/nilOwner to search for.
priorityparameternumber/nilPriority of the event handler. Higher numbers trigger first.

Texture:EventList

Lists the current event handlers for an event.

Usage:

result = Layout:EventList(handle)
ParameterTypeDatatypeDescription
handleparametereventFrameA handle to a frame event, usually pulled out of the "Event.UI." hierarchy.
resultresulttableA table of event handlers for this event.
members
handler The handler that will be called when the event fires.
label Human-readable label used to identify the handler in error reports, performance reports, and for later detaching.
macro The macro that will run when the event fires.
owner Owner to search for.
priority Priority of the event handler. Higher numbers trigger first.

Texture:EventMacroGet

Gets the macro that will be triggered when this event occurs.

Usage:

macro = Layout:EventMacroGet(handle)
ParameterTypeDatatypeDescription
handleparametereventFrameA handle to a frame event, usually pulled out of the "Event.UI." hierarchy.
macroresultstring/nilThe macro that will be triggered.

Texture:EventMacroSet

Sets the macro that will be triggered when this event occurs.

Usage:

Layout:EventMacroSet(handle, macro)
ParameterTypeDatatypeDescription
handleparametereventFrameA handle to a frame event, usually pulled out of the "Event.UI." hierarchy.
macroparameterstring/nilThe macro to trigger. nil to clear the macro.
requireSecureFrameAndInsecureEnvironment
true

Texture:GetAlpha

Gets the alpha multiplier of this frame.

Usage:

alpha = Element:GetAlpha()
ParameterTypeDatatypeDescription
alpharesultnumberThe alpha multiplier of this frame. 1 is fully opaque, 0 is fully transparent. This does not include multiplied alphas from this frame's parent - it's the exact value passed to SetAlpha.

Texture:GetBackgroundColor

Retrieves the background color of this frame.

Usage:

r, g, b, a = Element:GetBackgroundColor()
ParameterTypeDatatypeDescription
aresultnumberAlpha. 1 is fully opaque, 0 is fully transparent.
bresultnumberBlue.
gresultnumberGreen.
rresultnumberRed.

Texture:GetBottom

Retrieves the Y position of the bottom edge of this element.

Usage:

bottom = Layout:GetBottom()
ParameterTypeDatatypeDescription
bottomresultnumberThe Y position of the bottom edge of this element.

Texture:GetBounds

Retrieves the complete bounds of this element.

Usage:

left, top, right, bottom = Layout:GetBounds()
ParameterTypeDatatypeDescription
bottomresultnumberThe Y position of the bottom edge of this element.
leftresultnumberThe X position of the left edge of this element.
rightresultnumberThe X position of the right edge of this element.
topresultnumberThe Y position of the top edge of this element.

Texture:GetChildren

Returns a table containing all of this element's children.

Usage:

children = Element:GetChildren()
ParameterTypeDatatypeDescription
childrenresulttableA table containing this element's children.

Texture:GetEventTable

Retrieves the event table of this element. By default, this value is also stored in "this.Event".

Usage:

eventTable = Layout:GetEventTable()
ParameterTypeDatatypeDescription
eventTableresulttableThe event table of this element.

Texture:GetHeight

Retrieves the height of this element.

Usage:

height = Layout:GetHeight()
ParameterTypeDatatypeDescription
heightresultnumberThe height of this element.

Texture:GetKeyFocus

Gets the key focus status.

Usage:

focus = Element:GetKeyFocus()
ParameterTypeDatatypeDescription
focusresultbooleanWhether this frame is the current key focus.

Texture:GetLayer

Gets the frame's layer order.

Usage:

layer = Frame:GetLayer()
ParameterTypeDatatypeDescription
layerresultnumberThe render layer of this frame. See Frame:SetLayer for details.

Texture:GetLeft

Retrieves the X position of the left edge of this element.

Usage:

left = Layout:GetLeft()
ParameterTypeDatatypeDescription
leftresultnumberThe X position of the left edge of this element.

Texture:GetMouseMasking

Get the current mouse masking mode. See SetMouseMasking for details.

Usage:

mask = Element:GetMouseMasking()
ParameterTypeDatatypeDescription
maskresultstringThe current mouse masking mode.

Texture:GetMouseoverUnit

Gets the unit that is being represented by this frame.

Usage:

unit = Frame:GetMouseoverUnit()
ParameterTypeDatatypeDescription
unitresultstringThe current mouseover unit. May be nil if there is no mouseover unit.

Texture:GetName

Retrieves the name of this element.

Usage:

name = Layout:GetName()
ParameterTypeDatatypeDescription
nameresultstringThe name of this element, as provided by the addon that created it.

Texture:GetOwner

Retrieves the owner of this element.

Usage:

owner = Layout:GetOwner()
ParameterTypeDatatypeDescription
ownerresultstringThe owner of this element. Given as an addon identifier.

Texture:GetParent

Gets the parent of this frame.

Usage:

parent = Frame:GetParent()
ParameterTypeDatatypeDescription
parentresultElementThe parent element of this frame.

Texture:GetRight

Retrieves the X position of the right edge of this element.

Usage:

right = Layout:GetRight()
ParameterTypeDatatypeDescription
rightresultnumberThe X position of the right edge of this element.

Texture:GetSecureMode

Get the current secure mode. See SetSecureMode for details.

Usage:

secure = Frame:GetSecureMode()
ParameterTypeDatatypeDescription
secureresultstringThe current secure mode.

Texture:GetStrata

Gets the frame's strata. The strata determines render order on a coarser level than Layer does, as well as determining how far an element is brought to the front when clicked on.

Usage:

strata = Frame:GetStrata()
ParameterTypeDatatypeDescription
strataresultstringThe item's current strata.

Texture:GetStrataList

Gets a list of valid stratas for this frame.

Usage:

stratas = Frame:GetStrataList()
ParameterTypeDatatypeDescription
stratasresulttableAn array of valid stratas, in order.

Texture:GetTexture

Gets the current texture used for this element.

Usage:

source, texture = Texture:GetTexture()
ParameterTypeDatatypeDescription
sourceresultstringThe source of the resource. "Rift" will take the resource from Rift's internal data. Anything else will take the resource from the addon with that identifier.
textureresultstringThe actual texture identifier. Either a resource identifier or a filename.

Texture:GetTextureHeight

Returns the actual pixel height of the current texture.

Usage:

height = Texture:GetTextureHeight()
ParameterTypeDatatypeDescription
heightresultnumberThe height of the current texture in pixels.

Texture:GetTextureWidth

Returns the actual pixel width of the current texture.

Usage:

width = Texture:GetTextureWidth()
ParameterTypeDatatypeDescription
widthresultnumberThe width of the current texture in pixels.

Texture:GetTop

Retrieves the Y position of the top edge of this element.

Usage:

top = Layout:GetTop()
ParameterTypeDatatypeDescription
topresultnumberThe Y position of the top edge of this element.

Texture:GetType

Retrieves the type of this element.

Usage:

type = Layout:GetType()
ParameterTypeDatatypeDescription
typeresultstringThe type of this element.

Texture:GetVisible

Gets the visibility flag for this frame.

Usage:

visible = Element:GetVisible()
ParameterTypeDatatypeDescription
visibleresultbooleanThis frame's visibility flag, as set by SetVisible. Does not check the visibility flags of the frame's parents.

Texture:GetWidth

Retrieves the width of this element.

Usage:

width = Layout:GetWidth()
ParameterTypeDatatypeDescription
widthresultnumberThe width of this element.

Texture:ReadAll

Read all set points and sizes from this frame.

Usage:

results = Layout:ReadAll()
ParameterTypeDatatypeDescription
resultsresulttableResult table. Contains data in the following format: {x = {size = (size), [(position)] = {layout = (layout), position = (position), offset = (offset)}}, y = (the same thing)}.

Texture:ReadHeight

Read a set height from this frame.

Usage:

height = Layout:ReadHeight()
ParameterTypeDatatypeDescription
heightresultnumberThe parameter passed to SetHeight(), or nil if no such parameter has been passed.

Texture:ReadPoint

Read a set point from this frame. Must be given a single-axis coordinate.

Usage:

layout, position, offset = Layout:ReadPoint(coordinate)
layout, position, offset = Layout:ReadPoint(x, y)
origin, offset = Layout:ReadPoint(coordinate)
origin, offset = Layout:ReadPoint(x, y)
ParameterTypeDatatypeDescription
coordinateparameterstringNamed coordinate. Must be a one-axis coordinate.
xparameternumber/nilX coordinate of the point. Either this or Y must be nil.
yparameternumber/nilY coordinate of the point. Either this or X must be nil.
layoutresultLayoutThe table that this point is pinned to.
offsetresultnumberThe offset in pixels from the source location to the actual location.
originresultstringThe string "origin".
positionresultnumberThe position on "layout" that this point is pinned. 0 refers to the top or left edge, 1 refers to the bottom or right edge.

Texture:ReadWidth

Read a set width from this frame.

Usage:

width = Layout:ReadWidth()
ParameterTypeDatatypeDescription
widthresultnumberThe parameter passed to SetWidth(), or nil if no such parameter has been passed.

Texture:SetAllPoints

Pins all the edges of this frame to the edges of a different frame. If no target is given, defaults to this frame's parent.

Usage:

Frame:SetAllPoints()
Frame:SetAllPoints(target)
ParameterTypeDatatypeDescription
targetparameterLayoutTarget Layout to pin this frame's edges to.
noSecureFrameAndEnvironment
true

Texture:SetAlpha

Sets the alpha transparency multiplier for this frame and its children.

Usage:

Element:SetAlpha(alpha)
ParameterTypeDatatypeDescription
alphaparameternumberThe new alpha multiplier. 1 is fully opaque, 0 is fully transparent.

Texture:SetBackgroundColor

Sets the background color of this frame.

Usage:

Element:SetBackgroundColor(r, g, b)
Element:SetBackgroundColor(r, g, b, a)
ParameterTypeDatatypeDescription
aparameternumberAlpha. 1 is fully opaque, 0 is fully transparent. Defaults to 1.
bparameternumberBlue.
gparameternumberGreen.
rparameternumberRed.

Texture:SetHeight

Sets the height of this frame. Undefined results if the frame already has two pinned Y coordinates.

Usage:

Frame:SetHeight(height)
ParameterTypeDatatypeDescription
heightparameternumberThe new height of this frame.
noSecureFrameAndEnvironment
true

Texture:SetKeyFocus

Sets the key focus status. Note that only one frame can be the key focus at a time. Focusing on another frame will automatically unset the current focus.

Usage:

Element:SetKeyFocus(focus)
ParameterTypeDatatypeDescription
focusparameterbooleanThe new key focus setting.

Texture:SetLayer

Sets the frame layer for this frame. This can be any number. Frames are drawn in ascending order. If two frames have the same layer number, then the order of those frames is undefined, but guarantees no Z-fighting. Frames are always drawn after their parents.

Usage:

Frame:SetLayer(layer)
ParameterTypeDatatypeDescription
layerparameternumberThe new layer for this frame.
noSecureFrameAndEnvironment
true

Texture:SetMouseMasking

Sets the frame's mouse masking mode.

Usage:

Element:SetMouseMasking(mask)
ParameterTypeDatatypeDescription
maskparameterstringThe new mouse masking mode. "full" is the standard mode, and means that creating any Left, Right, or movement-related mouse event will cause the frame to accept and consume any event from any of those types. "limited" causes the frame to accept and consume only events for buttons that have been hooked, so that hooking "LeftDown" will still pass Right mouse events through the frame. Note that hooking any mouse event will still consume MouseMove/In/Out events.
noSecureFrameAndEnvironment
true

Texture:SetMouseoverUnit

Sets the unit that will be represented by this frame.

Usage:

Frame:SetMouseoverUnit(unit)
ParameterTypeDatatypeDescription
unitparameternil, unitThe new mouseover unit. May be a unit ID or a unit specifier. Pass in nil to disable the mouseover effect.
requireSecureFrameAndInsecureEnvironment
true

Texture:SetParent

Sets the parent of this frame. Circular dependencies result in undefined behavior. If this frame's secure mode is "restricted", then its parent must also have a secure mode of "restricted".

Usage:

Frame:SetParent(parent)
ParameterTypeDatatypeDescription
parentparameterElementThe new parent for this frame.
noSecureFrameAndEnvironment
true

Texture:SetPoint

Pins a point on this frame to a location on another frame. This is a rather complex function and you should look at examples to see how to use it.
This function can take many different forms. In general, it looks like this: SetPoint(point_on_this_frame, target_frame, point_on_target_frame [, x_offset, y_offset]).
The first part is the point on this frame that will be attached. Usually, these are string identifiers. "TOPLEFT", "TOPCENTER", "TOPRIGHT", "CENTERLEFT", "CENTER", "CENTERRIGHT", "BOTTOMLEFT", "BOTTOMCENTER", "BOTTOMRIGHT". You may also use a string identifier that refers to a single axis - "TOP", "BOTTOM", "LEFT", "RIGHT", "CENTERX", "CENTERY". If you want more direct numeric control you can use number pairs. 0,0 is equivalent to "TOPLEFT", 1,1 is equivalent to "BOTTOMRIGHT", 0.5,nil is equivalent to "CENTERX".
The second part is the frame to attach to, as well as the point on that frame to attach to. The frame is simply passing in the frame table. The point is the same identifier or number pair as the first parameter.
Optionally, you may include an X or Y offset to the point.
This connection is permanent, and if the target frame moves, this frame will move along with it.
Caveat: If the target is a frame set to the "restricted" SecureMode, and the client is currently in "secure" mode, then unexpected behavior may occur.

Usage:

Frame:SetPoint(...)
ParameterTypeDatatypeDescription
...parameter...This function's parameters are complicated. Read the above summary for details.
noSecureFrameAndEnvironment
true

Texture:SetSecureMode

Sets the frame's secure mode.
"normal" is the standard mode. It allows for most functionality to be used and does not restrict frames in combat. "restricted" allows for certain sensitive functions to be called, but disables a significant amount of functionality in combat. In order to change a frame to "restricted", its parent must already be "restricted". Note that a "restricted" frame can still have "normal" children.
If you are not planning to use any restricted functions, your frame should remain in normal mode.
At the moment, it is not possible to change from "restricted" back to "normal".

Usage:

Frame:SetSecureMode(secure)
ParameterTypeDatatypeDescription
secureparameterstringThe new secure mode. Valid inputs are "normal" and "restricted".

Texture:SetStrata

Sets the strata for this frame.

Usage:

Frame:SetStrata(strata)
ParameterTypeDatatypeDescription
strataparameterstringThe item's new strata. Must be one of the elements returned by :GetStrataList().
noSecureFrameAndEnvironment
true

Texture:SetTexture

Sets the current texture used for this element.

Usage:

Texture:SetTexture(source, texture)
ParameterTypeDatatypeDescription
sourceparameterstringThe source of the resource. "Rift" will take the resource from Rift's internal data. Anything else will take the resource from the addon with that identifier.
textureparameterstringThe actual texture identifier. Either a resource identifier or a filename.

Texture:SetVisible

Sets the frame's visibility flag. If set to false, then this frame and all its children will not be rendered or accept mouse input.

Usage:

Element:SetVisible(visible)
ParameterTypeDatatypeDescription
visibleparameterbooleanThe new visibility flag.
noSecureFrameAndEnvironment
true

Texture:SetWidth

Sets the width of this frame. Undefined results if the frame already has two pinned X coordinates.

Usage:

Frame:SetWidth(width)
ParameterTypeDatatypeDescription
widthparameternumberThe new width of this frame.
noSecureFrameAndEnvironment
true

Back to index...