TimeLeft Online Help  
Overview
What is TimeLeft
Floating Windows
Main Menu
Main Window
TimeLeft Free
TimeLeft Deluxe
Additional options and packs
How to Upgrade to TimeLeft Deluxe
System Requirements
How to...
Access Menu
Access Main Window
Reminder
Add New Reminder
Edit Reminder
Edit Message Window
Countdown
Add New Countdown
Edit Countdown
Export to Web
Edit Layout
Clock
Add New Clock
Edit Clock
Replace Window's clock
Edit Layout
Stopwatch
Add New Stopwatch
Edit Stopwatch
Edit Layout
Timer
Add New Timer
Edit Timer
Edit Layout
Sticker
Add New Sticker
Edit Sticker
Auction Watch
Add New Auction Watch
Edit Auction Watch
Synchronize Time
Resize floating windows
Export to Web
Workdays Countdown
Edit Layout
Edit Options
Scripting
Install and Uninstall
Support
Upgrade
Lost Registration Key
Reporting Problems
Contacts
FAQ
About NesterSoft
Scripting   Prev Next

Scripting allows you to create simple commands to control TimeLeft behavior.
For example, you can setup to hide a countdown when it ends; to show and start the second countdown when the first countdown ends; to start or pause a stopwatch when a reminder ends; to show a sticker, etc. Also you can setup keyboard shortcuts - to start or reset a timer (or several timers), to show or hide a clock, etc.

There are two types of scripts:
actions - these scripts run automatically when a reminder/countdown ends;
keyboard shortcuts - these scripts run when the specified shortcut is pressed.


Specifications

Script is a text line composed of one or more sentences separated with ; (semicolon). Each sentence describes one simple command. All texts are case-insensitive.

Sentence
format: object, id, command;

Object (a text word) specifies the type of the operated module (Reminder, Countdown etc.).
ID (a number or a text word) specifies the position of the operated module instance in the corresponding "Main Window" list (List of Reminders, Countdowns, etc).
Command (a text word) specifies the command.

Objects
TimeLeft TimeLeft application
Reminder,
Countdown,
Clock,
Stopwatch,
Timer,
Sticker,
AuctionWatch
corresponding modules


ID
Applies only to the modules. Ignored for the "TimeLeft" object.
1, 2, 3, ... position of the instance in the corresponding "Main Window" list
Current (Applies only to the "actions" type of script) Current instance - reminder or countdown which has this script in its actions.
Previous,
Next
(Applies only to the "actions" type of script) previous or next instance in the corresponding list
All,
First,
Last
All instances in the corresponding list, or first or last instance
ActiveAll, ActiveFirst, ActiveLast All active (currently shown on the desktop) instances in the corresponding list, or first or last active instance
InactiveAll, InactiveFirst, InactiveLast All inactive (currently not shown on the desktop) instances in the corresponding list, or first or last inactive instance

Command
"TimeLeft" object
Close Close TimeLeft application
Restore Restore TimeLeft
Hide Minimize TimeLeft
RestoreHide Restore TimeLeft if it's minimized or vice versa

Modules - all (common commands for all floating windows)
Enable Enable (show floating window) specified instance(s)
Disable Disable (hide floating window) specified instance(s)
EnableDisable Enable if it's currently disabled and vice versa

Modules - Reminder, Countdown
Reset Reset periodical reminder or countdown with the defined starting point.
Starting point must be "defined time" or "defined date/time" - then reminder or countdown will be restarted from the current date or date/time.
Periodical reminders are: Minutely, Hourly, Daily, Weekly, Monthly and Annually.

Modules - Stopwatch, Timer
Start Start stopwatch or timer
Pause Pause stopwatch or timer
StartPause Start if paused and vice versa
Reset Reset stopwatch or timer to it's start value


Examples

actions - setup at Reminder (or Countdown) Settings window, checkbox "Enable Actions".
Perform command when countdown ends:
Command Script
Hide ended countdown countdown,current,Disable
Show next countdown countdown,next,Enable
Show sticker #3 sticker,3,Enable
Start countdown #2 countdown,2,Start
Show first inactive clock clock,InactiveFirst,Show
Restore TimeLeft timeleft,,Restore
Setup intermittent reminders: remind in 5 minutes, then in 2 minutes, then in 5 again, so on:
create two periodical reminders - for 5 and for 2 minutes, both set starting point as "defined date/time", then set following action scripts:
First reminder (5 minutes): Reminder,next,enable; Reminder,next,reset; Reminder,current,disable
Second reminder (2 minutes): Reminder,previous,enable; Reminder,previous,reset; Reminder,current,disable
And then enable first reminder.

Keyboard shortcuts - setup at TimeLeft Options, tab Advanced, Enable shortcuts - "Edit" button.
Perform command when the keyboard shortcut is pressed (e.g. Ctrl-Alt-T):
Command Script
Reset first timer timer,first,Reset
Toggle show/hide clock #1 clock,1,EnableDisable
Toggle show/hide all stickers sticker,all,EnableDisable
Show stopwatch #2 and start it from the beginning stopwatch,2,Enable; stopwatch,2,Reset; stopwatch,2,Start
Restore or minimize TimeLeft timeleft,,RestoreHide

Back to TimeLeft
   (C) 1999-2009 NesterSoft Inc.