User Tools

Site Tools


dictionary:events:createevent

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revision Previous revision
dictionary:events:createevent [2021/02/15 13:26]
James Sentman [Passing Parameters To A Handler Example]
dictionary:events:createevent [2021/02/15 13:28] (current)
James Sentman
Line 3: Line 3:
  
 ===Usage:​=== ===Usage:​===
-**create event** (event name, or blank and XTension will create one for you)\\ +  * **create event** (event name, or blank and XTension will create one for you)\\ 
-**that** (command: turnson/​turnsoff/​toggles/​executes/​dims/​presets/​blocks/​unblocks)\\ +  ​* ​**that** (command: turnson/​turnsoff/​toggles/​executes/​dims/​presets/​blocks/​unblocks)\\ 
-**unit|script** (name of the unit or the script to act upon)\\+  ​* ​**unit|script** (name of the unit or the script to act upon)\\
  
 ===Optional Parameters:​=== ===Optional Parameters:​===
-**to level** (integer, the value for the chosen command)\\ +  * **to level** (integer, the value for the chosen command)\\ 
-**in** (seconds till the start time)\\ +  ​* ​**in** (seconds till the start time)\\ 
-**starts at** (AppleScript date at which to start the event)\\ +  ​* ​**starts at** (AppleScript date at which to start the event)\\ 
-**repeats every** (integer value in seconds)\\ +  ​* ​**repeats every** (integer value in seconds)\\ 
-**randomize by** (integer, minutes by which to randomize the repeat interval)\\ +  ​* ​**randomize by** (integer, minutes by which to randomize the repeat interval)\\ 
-**with no script** (perform the action, but dont run the unit scripts)\\ +  ​* ​**with no script** (perform the action, but dont run the unit scripts)\\ 
-**weekdays** (7 character string in the form of "​-MTWTF-"​ use dashes for days not to execute)\\ +  ​* ​**weekdays** (7 character string in the form of "​-MTWTF-"​ use dashes for days not to execute)\\ 
-**handler** (string, name of the handler) If executing a script you can optionally specify the handler to call rather than just running the script. This value is ignored unless the event is to execute a script. +  ​* ​**handler** (string, name of the handler) If executing a script you can optionally specify the handler to call rather than just running the script. This value is ignored unless the event is to execute a script.\\ 
-**parameter** A list of items to be optionally passed to the handler. Only valid if you are executing a handler in the script. The number of parameters in the list must be the same as expected by the handler.+  ​* ​**parameter** A list of items to be optionally passed to the handler. Only valid if you are executing a handler in the script. The number of parameters in the list must be the same as expected by the handler.
  
 ===Examples:​=== ===Examples:​===
Line 47: Line 47:
 in 10 minutes you would see output in the log like: in 10 minutes you would see output in the log like:
  
-**jamie has had breakfast**+jamie has had breakfast
  
  
 ===History:​=== ===History:​===
 The optional “handler” parameter was added in XTension 9.4.21 The optional “handler” parameter was added in XTension 9.4.21
dictionary/events/createevent.1613395589.txt.gz · Last modified: 2021/02/15 13:26 by James Sentman