Name
ShowRinghioMessage -- show a Ringhio notification (V6.0)
Synopsis
ShowRinghioMessage(title$, text$[, table])
Platforms
AmigaOS 4 only

Function
This function can be used to show a notification through AmigaOS 4's Ringhio system. You need to pass a title for the notification in the first argument and the actual text in the second argument.

The optional table argument can be used to specify additional parameters for the way the Ringhio notification should be handled. The following tags are accepted here:

PubScreen:
This tag can be used to specify the name of the public screen the notification should appear on.

ImageFile:
This tag can be used to specify the path to an image file that should be displayed inside the Ringhio notification. For the best results, you should use only PNG images with alpha channel here.

DoubleClickClose:
If you set this tag to True, the Ringhio notification window can be closed by double-clicking on it. In that case a message will be sent to your application containing the string you specify in the DoubleClickMessage tag (see below).

DoubleClickMessage:
If the user double-clicks the Ringhio notification window in order to close it, the string you specify here will be sent to your application using the OnApplicationMessage event handler. This tag is only supported if you have also set the DoubleClickClose tag to True (see above). If the string specified here has the following format "URL:http://www.example.com/" the Ringhio server will not send a message back to your application but it will automatically show the specified URL in the default browser if the user double-clicks on the notification window.

Please note that this function can only be used if you have set the RegisterApplication tag in @OPTIONS to True. See OPTIONS for details.

Inputs
title$
title for the Ringhio notification
text$
text to show in the Ringhio notification
table
optional: table containing further parameters (see above)

Show TOC