WoW:FrameXML elements

From AddOn Studio
Jump to navigation Jump to search

Overview

This document describes various important UI elements which are provided by the standard World of Warcraft FrameXML UI.

Tooltips

GameTooltip

This is the game's tooltip, it consists of a number of lines, to determine how many there are, you can call the GameTooltip:NumLines() function.

GameTooltipTextLeft<num>

Each line of text from the game tooltip is represented by one of these objects, replace <num> with the appropriate line number (from 1 to the number of lines returned from GameTooltip:NumLines()). To obtain the text of a line call the GameTooltipTextLeft<i><num></i>:GetText() function.

Example: Looping through all tooltip lines

local i = 1;
while (i <= GameTooltip:NumLines()) do
   local mytext = getglobal("GameTooltipTextLeft" .. i);
   local text = mytext:GetText();
   i = i + 1;
end

Notes

The tooltip displayed when the mouse is hovering over players and/or NPCs on the minimap is such that all the units being displayed are actually only on the first tooltip line. So, if the tooltip showed 4 players, the names are all in the first tootip line, delimited by "\n".

GameTooltipTextRight<num>

Some tooltips have both left- and right-aligned sections. In order to get at the right-aligned section, use one of these objects instead of a GameTooltipTextLeft. Otherwise, the functionality is identical.

MinimapCluster

Frame which represents the minimap area of the user interface.

Example: Determining if the mouse is over the minimap

if (MouseIsOver(MinimapCluster)) then
   -- do something
end