Patch 10.1.7/API changes

• Added a new Ping system.
• Fixed an issue where ScrollingFontTemplate could allow scrolling out-of-bounds or clip its contents if the frame size or font were modified.

• TOC:
• Diffs: wow-ui-source, BlizzardInterfaceResources

The ping system can be used to communicate contextual notifications to group members visualized via through a UI frame anchored in the game world.

This can be activated by pressing and holding the Ping hotkey (default ). Clicking the game world, units, or unit frames will send a contextual ping, where the type of the ping sent will be automatically inferred based upon what was clicked. Dragging the mouse while clicking will open a ping wheel to manually select the type of ping to send.

The API functions for sending pings are forbidden and may not directly be called by addons. Additionally, the frames used for displaying pings in the game world are forbidden objects and cannot be customized.

Insecure frames can opt-in to be ping receivers. This permits a ping to be automatically sent when a receiver frame is clicked during a ping interaction, with the target and type of the ping customizable by overriding two methods on the frame itself. Ping receivers can also be used to block ping interactions, preventing pings being sent if the frame is clicked.

To become a ping receiver a frame must meet either of the following conditions, with further details found in the documentation for.

• 1) The frame must be marked as top level and not have the attribute set.
• 2) The frame must have the attribute set.

For convenience, two templates are provided in FrameXML to apply these attributes.

• PingReceiverAttributeTemplate
• PingTopLevelPassThroughAttributeTemplate

The example below will create an icon in the middle of the screen that sends an "Attack" ping for your current target when clicked with the ping hotkey held.

For unit frames, a convenience mixin is also provided (PingableType_UnitFrameMixin) that will provide default implementations of the above functions to automatically ping the unit token stored in the field on the frame, and with an appropriate context based upon whether the unit is friendly or hostile.

Enum.CurrencyFlagsB + <font color="#00b400">FutureCurrencyFlag = 0x10 + <font color="#00b400">CurrencyBDontDisplayIfZero = 0x20 Enum.PingSubjectType + <font color="#00b400">OnMyWay = 3 + <font color="#00b400">AlertThreat = 4 + <font color="#00b400">AlertNotThreat = 5 - <font color="#ff6767">GroupHere