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 | ||
token:Variable [2015/12/13 05:43] JMichaelTX Add link to Insert Text action |
token:Variable [2016/05/23 22:55] peternlewis |
||
---|---|---|---|
Line 1: | Line 1: | ||
- | {{:token:variable-icon.png |}}===== Keyboard Maestro Variables ===== | + | {{:token:variable-icon.png |}} |
- | ==== Variable Tokens ==== | + | The //%Variable%//`<VariableName>`% token allows you to include a [[:Variables|variable]] in a [[:Text Fields |token text field]], where `<VariableName>` is the name of the variable. |
- | The //%Variable%// token allows you to include a variable in a token text field. For Example, | ||
- | [[action:Insert_Text|Insert Text]]: Sally said “Hello” to %Variable%First Name%. | + | For Example, using the [[action:Insert_Text|Insert Text]] Action: |
+ | |||
+ | {{ :token:km-wiki-insert-text-action.png?nolink |}} | ||
You can also use a short form of just //%Variable Name%// to include variables as long as the variable exists and has a value and there is no corresponding text token, although generally it is better and clearer to use the longer form //%Variable%Variable Name%//. | You can also use a short form of just //%Variable Name%// to include variables as long as the variable exists and has a value and there is no corresponding text token, although generally it is better and clearer to use the longer form //%Variable%Variable Name%//. | ||
- | ==== Variable Arrays ==== | + | ===== See Also ===== |
- | + | ||
- | Variables can contain an array of comma separated **numbers**, like the image size (123,456) or window frame (100,120,600,550). In a calculation field, you can refer to these using a normal (1-based) index notation, like Variable[2]. So you can use ClipboardImageSize[1] and ClipboardImageSize[2]. | + | |
- | + | ||
- | **It is important to note that variable arrays can contain only numeric values**. When you use the [[token:Calculate|%Calculate%]] function to reference a variable array element, it will convert the element to a number. So, in effect, you can only use variable arrays to store/reference numbers. | + | |
- | For example, suppose the variable `MyArray` has this value: `10,05,00,12` | + | - [[:Text Fields]] |
- | In any Keyboard Maestro Action where you would like to use the array element `%Calculate%MyArray[2]`, it will return "5" because it has evaluated it as number, not the actual string of the element "05". | + | - [[:Tokens]] |
+ | - [[:Variables]] | ||