User Tools
manual:Tokens
Differences
This shows you the differences between two versions of the page.
| Both sides previous revision Previous revision Next revision | Previous revision Next revision Both sides next revision | ||
|
manual:Tokens [2019/08/25 17:00] JMichaelTX Major rewrite with examples and images |
manual:Tokens [2019/09/17 08:34] peternlewis |
||
|---|---|---|---|
| Line 6: | Line 6: | ||
| 2. [[:Functions|Functions]] (returns numbers, used in numeric fields ) | 2. [[:Functions|Functions]] (returns numbers, used in numeric fields ) | ||
| - | You can enter a Token in any [[/Text_Fields|text field]] in an [[:Actions|Action]], and when the Macro is triggered and the Action is executed, the token will be replaced by the value that is returned at run time. | + | You can enter a Token in any [[/Text_Fields|text field]] in an [[:Actions|Action]], and when the Macro is triggered and the Action is executed, the token will be replaced by the value that is returned at run time. This allows you to easily combine static text with dynamic data that is supplied at run time, in most any Action that has a text field, like [[action:Display_Text|Display Text]] and [[action:Set_Variable_to_Text|Set Variable to Text]]. |
| ===== Token Format ===== | ===== Token Format ===== | ||
| Line 40: | Line 40: | ||
| The "`[]()`" are just characters you type. | The "`[]()`" are just characters you type. | ||
| - | That's all you need for a great macro, which you can download from here. | + | After the macro and Action are executed, you will see this on the Clipboard: |
| + | |||
| + | {{:manual:token-demo-display-clipboard.png?nolink|}} | ||
| + | |||
| + | That's all you need for a great macro, which you can [[https://forum.keyboardmaestro.com/t/set-clipboard-to-markdown-link-of-frontmost-browser-wiki-example-macro-v9-0-1d2/15025|download from here]]. | ||
| Line 52: | Line 56: | ||
| * Just tokens (not backslashed characters) or | * Just tokens (not backslashed characters) or | ||
| * Do not process any text. | * Do not process any text. | ||
| - | |||
| - | |||
| - | If you want to use the percent `%` character as a normal character, simply double the percent (`%%`). \\ | ||
| - | To use a backslash `\` in your text, double the backslash (`\\`). | ||
| Line 62: | Line 62: | ||
| === Non-Printing Control Characters === | === Non-Printing Control Characters === | ||
| - | An exception to the rule of enclosing Tokens in percent `%` characters, is the use of these Non-Printing Control Characters:\\ | + | An exception to the rule of enclosing Tokens in percent `%` characters, is the use of these Non-Printing Control Characters `\a,\b,\e,\f,\t,\r,\n` which correspond to (bell,backspace,escape,form feed,tab,return,line feed). These will be replaced with their value in text fields, except for Regular Expression (RegEx) fields. |
| - | `\a,\b,\e,\f,\t,\r,\n` \\ | + | |
| - | which correspond to (bell,backspace,escape,form feed,tab,return,line feed).\\ | + | |
| - | These will be replaced with their value in text fields, except for Regular Expression (RegEx) fields. | + | |
| === Convert Hex to Unicode Characters === | === Convert Hex to Unicode Characters === | ||
| Line 96: | Line 93: | ||
| With tokens that return a list of information (comma separated by default), you can access the individual items using the Variable array notation, append the item number in square brackets `[ ]` to the Token name, just before the closing `%`. | With tokens that return a list of information (comma separated by default), you can access the individual items using the Variable array notation, append the item number in square brackets `[ ]` to the Token name, just before the closing `%`. | ||
| - | For example:\\ | + | For example: |
| Token for Window Frame, [[token:WindowFrame | %WindowFrame[3]%1%]], will be the third comma-separated value, which is the Window width in this case. | Token for Window Frame, [[token:WindowFrame | %WindowFrame[3]%1%]], will be the third comma-separated value, which is the Window width in this case. | ||
manual/Tokens.txt · Last modified: 2023/10/02 00:10 by peternlewis
Page Tools
