Fandom

WoWWiki

API UIFrameFlash

104,632pages on
this wiki
Add New Page
Talk0 Share

Ad blocker interference detected!


Wikia is a free-to-use site that makes money from advertising. We have a modified experience for viewers using ad blockers

Wikia is not accessible if you’ve made further modifications. Remove the custom ad blocker rule(s) and the page will load as expected.


WoW API < UIFrameFlash
Icon-information-22x22This function is implemented by FrameXML in [DEPRECATED http://wowprogramming.com/utils/xmlbrowser/live/FrameXML/UIParent.lua FrameXML/UIParent.lua].

Flashes a frame by fading it in/out and showing/hiding it at the end.

UIFrameFlash(frame, fadeInTime, fadeOutTime, flashDuration, showWhenDone, flashInHoldTime, flashOutHoldTime)

Parameters Edit

Arguments Edit

frame, fadeInTime, fadeOutTime, flashDuration, showWhenDone, flashInHoldTime, flashOutHoldTime
frame 
Frame Pointer - frame to fade in / out.
fadeInTime 
Number - duration of the fade in effect.
fadeOutTime 
Number - duration of the fade out effect.
flashDuration 
Number - number of seconds to keep repeating the fade in / out cycle.
showWhenDone 
Boolean - should the frame be visible at the end?
flashInHoldTime
Number - number of seconds to hold the fully hidden state.
flashOutHoldTime 
Number - number of seconds to hold the fully visible state.

Returns Edit

This function does not return any values.

Example Edit

UIFrameFlash(UIParent, 1, 2, 15, true, 12, 0)

Result Edit

The UIParent frame and all its children are at first hidden. The UIParent then fades in (1 second), fades out (2 seconds), stays hidden for 12 seconds, and fades in again, remaining shown this time.

Details Edit

Several important things to note when using UIFrameFlash:

  • Flash cycle starts at hidden. If you call UIFrameFlash on an already visible frame, it'll be hidden.
  • Flashing works by modifying the frame's alpha value (:SetAlpha). All of the frame's children fade with their parent frame.
  • You can not flash the WorldFrame (fails silently).
  • If you try to flash an already flashing frame, the function fails silently. You may use UIFrameIsFading (frame) to detect if a frame is already flashing, and UIFrameFlashRemoveFrame (frame) to stop the flashing cycle prematurely (make sure to set the desired alpha value manually afterwards).
  • Once flashDuration expires, the frame's alpha is bluntly set to either 1 or 0 (depending on showWhenDone). Make sure to set a flashDuration value to coincide with the end of a fade in (if you want the frame to remain visible) or fade out (if not). Otherwise, things will look awkward.
  • The frame MUST have a name, otherwise one of the internal functions causes an error.

Also on Fandom

Random Wiki