SetWindowFlashing: Difference between revisions

From Multi Theft Auto: Wiki
Jump to navigation Jump to search
m (spacing)
No edit summary
 
(3 intermediate revisions by 3 users not shown)
Line 1: Line 1:
__NOTOC__
__NOTOC__
{{Client function}}
{{Client function}}
{{New feature/item|3.0160|1.6|7653|This function allows the window to flash in the Windows taskbar.}}
{{New feature/item|3.0152|1.5.2||This function allows the window to flash in the Windows taskbar.}}


== Syntax ==
== Syntax ==
<syntaxhighlight lang="lua">
<syntaxhighlight lang="lua">
bool setWindowFlashing ( bool shouldFlash[, int count= 10] )
bool setWindowFlashing ( bool shouldFlash [, int count = 10 ] )
</syntaxhighlight>
</syntaxhighlight>


=== Arguments ===
=== Required Arguments ===
* '''shouldFlash:''' whether the window should flash
* '''shouldFlash:''' whether the window should flash
* '''count''' ''(optional)''''':''' the number of times the window should flash, defaults to '''10 times'''
 
=== Optional Arguments ===
* '''count:''' the number of times the window should flash, defaults to '''10 times'''


=== Returns ===
=== Returns ===
Line 16: Line 18:
* the window is already in focus
* the window is already in focus
* the client has disabled this feature
* the client has disabled this feature
* ''count'' is ''0'' (flashing forever)


Returns '''true''' otherwise
Returns '''true''' otherwise

Latest revision as of 18:37, 24 January 2016

This function allows the window to flash in the Windows taskbar.

Syntax

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

Required Arguments

  • shouldFlash: whether the window should flash

Optional Arguments

  • count: 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

Returns true otherwise

Example

A command that allows the player to flash their window three times after one second.

addCommandHandler("flash",
	function()
		setTimer(setWindowFlashing, 1000, 1, true, 3)
	end
)


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