Messages, Reminders, Hints
Hint displaying options
Displays a message box with a specified text.
User-defined variables and nnCron's predefined variables can be used in text of a message. To add a quotation mark character and percent sign character to the text of a message, use variables %QUOTE% and %PERCENT% respectively. By using variable %FILE: filename%, you can display contents of a specified file in a message box.
After a message box has been displayed, execution of the task is suspended until the user clicks OK button.
Examples:
MSG: "Work is 100%PERCENT% complete" MSG: "Hello, %USERNAME%!" MSG: "Isn't it time to go home?"
There also exist a postfix version of this command:
S" Hello, world!" MsgBox
\ converting number on the stack ('115') to a string \ and displaying it on screen
115 N>S MsgBox
TMSG: "msg_text" <time_in_sec>
This word works similarly to MSG, but it displays a message only for a specified time (in seconds), after which it closes the message and resumes execution of the task. A user can close the message before this time has elapsed by clicking OK button.
Examples:
\ this message is displayed for three seconds TMSG: "Everything's ready!" 3 \ this message is displayed for five second TMSG: "Hello, %USERNAME%!" 5
There also exist a postfix version of this word:
S" Hello, world!" 3 TimeMsgBox
Works just like MSG, but contains an error icon instead of information icon.
ERR-MSG is best used to warn a user that something has gone wrong.
This word displays a query message box with a specified question. If the user answers affirmatively (clicks YES), QUERY: returns TRUE (-1).
Example:
#( test_query \ every weekday, at 18:00 querying the user \ and turning off the computer if he answers YES Time: 0 18 * * 1-5 * Rule: QUERY: "Shutdown your PC?" Action: POWEROFF )#
TQUERY: "query_text" <timeout_in_sec> Yes/No
Similar to QUERY:, but waits for the user's response during a specified number of seconds. If user does not respond, the value specified in the last argument will be used as the answer (Yes or No).
Example:
#( test_tquery \ every weekday, at 18:00 querying the user \ and turning off the computer if the user answers YES \ or if he does not respond within 30 seconds Time: 0 18 * * 1-5 * Rule: TQUERY: "Shutdown your PC?" 30 Yes Action: POWEROFF )#
Displays a message accompanied by a sound signal and provides an option to repeat it after a certain number of minutes.
Sometimes reminders may have been missed because nnCron was not running. Select 'Display missed reminder' checkbox if you want nnCron to run missed reminder 'at the first opportunity' - at the top of the first minute after nnCron startup (see this chapter for details).
Displays a small hint message and proceeds with execution of the task, regardless of user's reaction.
You can move a hint to any place on the screen by simply dragging it with your mouse.
A hint can be closed either manually (by right-clicking on it and selecting Close from context menu) or programmatically from the task, by using word HINT-OFF.
See also Hint Options.
Closes a hint message
Similar to HINT, but suspends execution of the task until the user closes hint message manually or until it is closed with HINT-OFF.
See also Hint Options.
THINT: "hint_text" <time_in_sec>
Displays a hint during a specified period of time (in seconds). A user can close the hint earlier by clicking on it. Task execution is not suspended.
See also Hint Options.
THINTW: "hint_text" <time_in_sec>
Displays a hint during a specified period of time (in seconds), suspending execution of the task. After the time expires, the hint automatically closes and execution of task is resumed. The user can close the hint at any time by clicking on it.
See also Hint Options.
You can use the following options before words HINT:, HINTW:, THINT: and THINTW: to control size and position of hint box:
HINT-POS: x y | specify position of hint box |
HINT-SIZE: w h | specify dimensions of hint box |
Example:
HINT-POS: 100 100 HINT-SIZE: 100 100 THINT: "This is a hint" 5
BALLOON: "balloon_title" "balloon_text"
Displays a small hint message with a specified title and text and proceeds with execution of the task regardless of the user reaction. The balloon hint appears near nnCron icon in system tray.
A hint can be closed by clicking on it or on Close button in the upper
right corner. If a hint is not closed manually, it will disappear by itself
after some time.
Word BALLOON: can be used only in Win2000/XP.
Example:
#( test_backup NoActive Action: BALLOON: "Attention!" "Task %QUOTE%%CUR-TASK-NAME%%QUOTE% has been started" BEEP: 250 500 )#
You can customize BALLOON: behaviour using the following variables:
Example:
#( test_backup1 NoActive Action: \ in the case of error 30000 BalloonTime ! 3 BalloonIcon ! BALLOON: "Error!" "Error in task %QUOTE%%CUR-TASK-NAME%%QUOTE%" BEEP: 250 500 )#
There also exist a postfix version of this command:
S" title" S" text" BALLOON
Note: if BALLOON: seems not to work on your PC (Win2000/XP) check the following registry path: HKEY_CURRENT_USER\Software\Microsoft\Windows\CurrentVersion\Explorer\Advanced. The value EnableBalloonTips need to be set to dword:00000001.
See also: TrayIconBalloonClick:, OnBalloonClick.
See also: