CreateTrayNotification: Difference between revisions

From Multi Theft Auto: Wiki
Jump to navigation Jump to search
(Add known issue)
Line 37: Line 37:
-- Show a default notification without sound
-- Show a default notification without sound
createTrayNotification( "Hello World", "default", false )
createTrayNotification( "Hello World", "default", false )
</syntaxhighlight>
==Example of notification on minimize MTA application==
<syntaxhighlight lang="lua">
function setTrayOnMinimize( )
    createTrayNotification( "We are waiting for you again...", "warning" )
end
addEventHandler( "onClientMinimize", getRootElement( ), setTrayOnMinimize )
</syntaxhighlight>
</syntaxhighlight>


==See Also==
==See Also==
{{Client_utility_functions}}
{{Client_utility_functions}}

Revision as of 14:25, 8 May 2017

This functions creates a notification ballon on the desktop.

[[{{{image}}}|link=|]] Note: MTA won't show any tray notifications if the MTA window is focused, because there is no reason to show tray notifications if you are ingame. If you want to test this function you should use a Timer and switch to your desktop.
[[{{{image}}}|link=|]] Note: You can only show a tray notification every 30 seconds.
[[{{{image}}}|link=|]] Note: Windows 10 isn't compatible with the function for now so dialogue won't pop out (see below at Issues)

Issues

Issue ID Description
#9447 createTrayNotification not working for Windows 10

Syntax

bool createTrayNotification ( string notificationText, [ string iconType = "default", bool useSound = true ] )

Required Arguments

  • notificationText: The text to send in the notification.

Optional Arguments

  • iconType: The notification icon type. Possible values are: "default" (the MTA icon), "info", "warning", "error"
  • useSound: A boolean value indicating whether or not to play a sound when receiving the notification.

Returns

Returns true if the notification is correctly created, false otherwise.

Example

-- Note: You have to wait 30 seconds before showing another tray notification, there is no queuing

-- Show a 'Hello World' notification
createTrayNotification( "Hello World" )

-- Show a notification with a warning symbol
createTrayNotification( "Hello World", "warning" )

-- Show a default notification without sound
createTrayNotification( "Hello World", "default", false )

Example of notification on minimize MTA application

function setTrayOnMinimize( )
     createTrayNotification( "We are waiting for you again...", "warning" )
end
addEventHandler( "onClientMinimize", getRootElement( ), setTrayOnMinimize )

See Also