WoW API: GetTalentTabInfo

Reference e
AddOns WoW API Widget API XML UI Event API WoW Lua Macro API CVars Battle.net HOWTOs Snippets UI tech Categories

→ WoW API

← WoW API < GetTalentTabInfo

Returns the information of the talent tab (tree)

name, iconTexture, pointsSpent, background, previewPointsSpent = GetTalentTabInfo(tabIndex[, inspect[, isPet]][, talentGroup])

Arguments

tabIndex

Number - Specifies which tab (tree) to identify.

inspect

Boolean - If true returns the information for the inspected unit instead of the player. New with 2.3.

isPet

Boolean - If true then the current pet's talents are examined instead of a player. New with 3.0.2.

talentGroup

Number - Optionally specifies which talent group (dual spec) to query.

Returns

name

String - The name of that tab.

iconTexture

String - Path and file name of tab icon.

pointsSpent

Integer - Number of points put into that tab.

background

String - File name of background image.

previewPointsSpent

Number - Points spent in tab.

Example

The following code displays the tabIndex number for each tab followed by the name of the tab.

for i = 1, GetNumTalentTabs() do
       DEFAULT_CHAT_FRAME:AddMessage( i .. ' ' .. GetTalentTabInfo(i) .. ' ' )
end

Notes

• Passing a true value for isPet should only work if the player is a hunter and has a pet active.
• In order for this function to return any useful information one of the following must occur:
  • You're using it to get information regarding your player's current spec. In which case, you will not be passing the second argument. The client already knows everything it needs to know about you, so you don't need to inspect yourself.
  • You're currently inspecting the unit and pass true as the second argument. In other words, the inspect frame is open and you have a target.
  • You're calling NotifyInspect(unit), are waiting for INSPECT_TALENT_READY to fire, and are passing true as the second argument. After the event fires, the client will have the information you desire.