Wowpedia

We have moved to Warcraft Wiki. Click here for information and the new URL.

READ MORE

Wowpedia
Advertisement

Returns the first suitable frame that may intercept a ping that can be found at the given screen position.

frame = C_PingSecure.GetTargetPingReceiver(mousePosX, mousePosY)

Arguments[]

mousePosX
number
mousePosY
number

Returns[]

frame
ScriptRegion

Details[]

  • This function should typically be supplied the return values of GetCursorPosition.
  • This function will return the first frame in the frame stack that meet either of the following criteria:
    • Any frame that is both marked as top level (Frame:SetToplevel) and does not have the ping-top-level-pass-through attribute set.
    • Any frame that has the ping-receiver attribute set.
  • When determining if an attribute is set, this function only checks if the attribute has a non-nil value. Notably, this means that setting either of these attributes to false will still result in the attribute being considered as set.
  • The behavior of this function if it encounters a frame that meets a mutually exclusive set of criteria should be considered undefined. However, currently if a frame is both marked as top level and has the ping-top-level-pass-through attribute set then the ping-receiver attribute will be ignored and the frame will not be returned.

Patch changes[]

Dragonflight Patch 10.1.7 (2023-09-05): Added.

Advertisement