SetWindowFlashing

From Multi Theft Auto: Wiki
Revision as of 17:30, 4 December 2015 by Qaisjp (talk | contribs) (Created page with "__NOTOC__ {{Client function}} {{New feature/item|3.0160|1.6|7653|This function allows the to flash in the Windows taskbar.}} == Syntax == <syntaxhighlight lang="lua"> bool setWindowFlashing...")
(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)
Jump to navigation Jump to search

ADDED/UPDATED IN VERSION 1.6 r7653:
This function allows the to flash in the Windows taskbar.

Syntax

bool setWindowFlashing ( bool shouldFlash[, int count= 10] )

Arguments

  • shouldFlash: whether the window should flash
  • count (optional): the number of times the window should flash, defaults to 10 times

Returns

Returns false if:

  • the window is already in focus
  • the client has disabled this feature
  • count is 0 (flashing forever)

Returns 'true otherwise

Example

A command that allows the player to flash their window three times after one second. A command that allows the player to flash their window after a certain period of time for a certain count.

addCommandHandler("flash",
	function(_, wait, count)
		wait = tonumber(wait) -- makes "wait" a number, this will be false if it can't be converted
		shouldFlash = type(wait) == "number" -- if wait is given, we should flash, otherwise we shouldn't
		wait = wait or 5-- make wait default to 1 second if it isn't a number
		count = tonumber(count) or 5 -- makes "count" a number, 5 if it can't be converted

		setTimer(setWindowFlashing, wait*1000, 1, shouldFlash, count)
	end
)

See also

BETA: NEW FEATURE (BUILD: 1.5.8 r20840)
BETA: NEW FEATURE (BUILD: 1.5.8 r20788)
BETA: NEW FEATURE (BUILD: 1.5.8 r20788)
BETA: NEW FEATURE (BUILD: 1.5.8 r20840)