Frame:RegisterUnitEvent

Main Menu
WoW API Lua API FrameXML Widget API Widget scripts XML schema Events CVars Macro commands Combat Log Escape sequences Hyperlinks API changes HOWTOs wowuidev

	Frame:RegisterEvent
	Frame:RegisterUnitEvent
	Frame:RegisterAllEvents
	Frame:UnregisterEvent
	Frame:UnregisterAllEvents
	Frame:IsEventRegistered

Registers the frame for a specific event, triggering only for the specified units.

registered = Frame:RegisterUnitEvent(eventName [, unit1, ...])

Arguments

eventName

string - Name of the frame event.

unit1, ...

string? : UnitId - A list of units (up to four units).

Returns

registered

boolean

Details

• Repeated calls will overwrite old registrations. Calling Frame:RegisterEvent will also overwrite the old registration.
• If no unit is given, then all units will be watched; which is virtually the same as calling Frame:RegisterEvent.

Example

local function OnEvent(self, event, ...)
	print(event, ...)
end

local f = CreateFrame("Frame")
f:RegisterUnitEvent("UNIT_HEALTH", "player", "party1", "party2", "party3")
f:SetScript("OnEvent", OnEvent)

Patch changes

Patch 5.0.4 (2012-08-28): Added.