WoW:API Frame GetAttribute: Difference between revisions

From AddOn Studio
Jump to navigation Jump to search
(Created page with '{{widgetmethod}} Returns the value of a specific attribute (or an attribute matching the prefix/suffix arguments). value = frame:GetAttribute(name); value = frame:GetAttribute(...')
 
m (typos)
Line 6: Line 6:
==Arguments==
==Arguments==
; prefix : String - modifier prefix string: a concatenation of alt-, ctrl-, and shift-, whichever apply, in that order.
; prefix : String - modifier prefix string: a concatenation of alt-, ctrl-, and shift-, whichever apply, in that order.
; name : Attribute name. If passes as the only attribute, this may be a fully qualified value; otherwise, it is the unmodified name of the attribute being retrieved.
; name : Attribute name. If passed as the only argument, this may be a fully qualified value; otherwise, it is the unmodified name of the attribute being retrieved.
; suffix : String - button suffix string: either a numeric string or a dash followed by an arbitrary button name.
; suffix : String - button suffix string: either a numeric string or a dash followed by an arbitrary button name.



Revision as of 01:44, 18 July 2009

Widget API ← Frame < GetAttribute

Returns the value of a specific attribute (or an attribute matching the prefix/suffix arguments).

value = frame:GetAttribute(name);
value = frame:GetAttribute(prefix, name, suffix);

Arguments

prefix
String - modifier prefix string: a concatenation of alt-, ctrl-, and shift-, whichever apply, in that order.
name
Attribute name. If passed as the only argument, this may be a fully qualified value; otherwise, it is the unmodified name of the attribute being retrieved.
suffix
String - button suffix string: either a numeric string or a dash followed by an arbitrary button name.

Returns

value
Mixed - the value of the matching attribute; nil if no attribute matched the arguments.

Matching order

When invoked with three arguments, this function attempts to return attributes in the following order (returning the first attribute that exists):

  1. prefix .. name .. suffix
  2. "*" .. name .. suffix
  3. prefix .. name .. "*"
  4. "*" .. name .. "*"
  5. name