Wiley-World.of.Warcraft.Programming.A.Guide.and.Reference.for.Creating.WoW.Addons

Chapter 27 ■ API Reference 949Only applies when the player has attempted to cast a spell but the spellrequires a target before it can begin casting (i.e. the glowing hand cursor isshowing).Returns:canTarget—1 if the spell can target an item; otherwise nil (1nil)SpellCanTargetUnitReturns whether the spell currently awaiting a target can target a given unit.canTarget = SpellCanTargetUnit(“unit“) or SpellCanTargetUnit(“name“)Only applies when the player has attempted to cast a spell but the spellrequires a target before it can begin casting (i.e. the glowing hand cursor isshowing).Arguments:unit—A unit to target (string, unitID)name—The name of a unit to target; only valid for player, pet, and party/raidmembers (string)Returns:canTarget—1 if the spell currently awaiting targeting can target the given unit(1nil)SpellHasRangeReturns whether an item has a range limitation for its use.hasRange = SpellHasRange(index, “bookType“) or SpellHasRange(“name“)For example: Shadowbolt can only be used on a unit within a given range ofthe player; Ritual of Summoning requires a target but has no range restriction;Fel Armor has no target and thus no range restriction.Arguments:index—Index of a spell in the spellbook (number, spellbookID)bookType—Type of spellbook (string)pet—The pet’s spellbookspell—The player’s spellbookname—Name of a spell (string)Returns:hasRange—1 if the spell has an effective range; otherwise nil. (1nil)SpellIsTargetingReturns whether a spell is currently awaiting a target.isTargeting = SpellIsTargeting()ProtectedReturns:isTargeting—1 if a spell is currently awaiting a target; otherwise nil (1nil)SpellStopCastingStops casting or targeting the spell in progress.