WoW:API EquipItemByName: Difference between revisions

From AddOn Studio
Jump to navigation Jump to search
(Also works with itemId and itemLink!)
(Added info regarding 3.3.0 changes)
Line 11: Line 11:
:;[[itemLink]] : String - The [[itemLink]], when Shift-Clicking items.
:;[[itemLink]] : String - The [[itemLink]], when Shift-Clicking items.
:;[[inventorySlotId|slot]] : Numeric - ''(optional)'' - The [[InventorySlotId|inventory slot]] to put the item in, obtained via [[API GetInventorySlotInfo|GetInventorySlotInfo()]].
:;[[inventorySlotId|slot]] : Numeric - ''(optional)'' - The [[InventorySlotId|inventory slot]] to put the item in, obtained via [[API GetInventorySlotInfo|GetInventorySlotInfo()]].
== Changes in 3.3.0 ==
When in combat this function now "picks up" the item instead of equipping it, similar to [[API_PickupInventoryItem|PickupInventoryItem]].  Out of combat, the function behaves as expected.  This change was made to address the issue of rogues using "poison swapping" addons to increase their DPS.<ref>{{ref web|url=http://forums.worldofwarcraft.com/thread.html?topicId=21042559255&pageNo=1&sid=1#6|title=Blue post confirming 3.3.0 change}}</ref>
== References ==
{{reflist}}

Revision as of 21:43, 11 December 2009

WoW API < EquipItemByName

Equips an item, optionally into a specified slot.

EquipItemByName(itemId or "itemName" or "itemLink"[, slot])

Parameters

Arguments

(itemId or "itemName" or "itemLink"[, slot])
itemId
Integer - The numeric ID of the item. ie. 12345
itemName
String - The name of the item, ie "Worn Dagger". Partial names are valid inputs as well, ie "Worn". If several items with same piece of name exists, the first one found will be equipped.
itemLink
String - The itemLink, when Shift-Clicking items.
slot
Numeric - (optional) - The inventory slot to put the item in, obtained via GetInventorySlotInfo().

Changes in 3.3.0

When in combat this function now "picks up" the item instead of equipping it, similar to PickupInventoryItem. Out of combat, the function behaves as expected. This change was made to address the issue of rogues using "poison swapping" addons to increase their DPS.[1]

References