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

884 Part IV ■ ReferenceMay cause one or more CALENDAR_UPDATE_* events to fire depending on thecontents of the player’s calendar. In the default UI, called when the calendar isshown.OpeningCinematicDisplays the introductory cinematic for the player’s race.Only has effect if the player has never gained any experience.PartialPlayTimeReturns whether the player is near the allowed play time limit.partialPlayTime = PartialPlayTime()ConfirmationProtectedProtectedWhen in this state, the player receives half the normal amount of money andXP from kills and quests and cannot use trade skills; returning to normalrequires logging out of the game for a period of time (see GetBillingTimeRested).Only used in locales where the length of play sessions is restricted (e.g.mainland China).Returns:partialPlayTime—1 if the character gains only partial xp, nil if not. (1nil)PetAbandonReleases the player’s pet.For Hunter pets, this function sends the pet away, never to return (in thedefault UI, it’s called when accepting the ‘‘Are you sure you want topermanently abandon your pet?’’ dialog). For other pets, this function isequivalent to PetDismiss().PetAggressiveModeEnables aggressive mode for the player’s pet.In this mode, the pet automatically attacks any nearby hostile targets.PetAttackInstructs the pet to attack.PetAttack([“unit“]) or PetAttack([“name“])The pet will attack the player’s current target if no unit is specified.Arguments:unit (optional)—A unit to attack (string, unitID)name (optional)—The name of a unit to attack (string)PetCanBeAbandonedReturns whether the player’s pet can be abandoned.canAbandon = PetCanBeAbandoned()Only Hunter pets can be permanently abandoned.Returns:canAbandon—1 if the player’s pet can be abandoned, otherwise nil (1nil)