User Tools
manual:Dictionaries
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:Dictionaries [2017/09/04 01:54] peternlewis [See Also] |
manual:Dictionaries [2017/10/05 23:02] peternlewis [Dictionaries] |
||
|---|---|---|---|
| Line 3: | Line 3: | ||
| Keyboard Maestro includes permanently stored dictionaries that you can use or set. | Keyboard Maestro includes permanently stored dictionaries that you can use or set. | ||
| - | A dictionary is a mapping from a key name to a value. You can have multiple dictionaries, each with their own name (so really, it is a mapping from a dictionary name and a key name to a value). | + | A dictionary is a set of mappings from a key name to a value. You can have multiple dictionaries, each with their own name (so really, it is a set of mappings from a dictionary name and a key name to a value). |
| Dictionary names start with a alphabetic character, followed by any number of alphanumeric, space or underscores. Dictionary names are case insensitive. | Dictionary names start with a alphabetic character, followed by any number of alphanumeric, space or underscores. Dictionary names are case insensitive. | ||
| Line 10: | Line 10: | ||
| Dictionary values are plain text and can include leading or trailing white space. | Dictionary values are plain text and can include leading or trailing white space. | ||
| + | |||
| + | For example, you might have a dictionary named "Shop Prices", with keys being the item names and values being the cost of the item. | ||
| + | |||
| + | ^Dictionary^Name^Value^ | ||
| + | | Shop Prices \\ Shop Prices \\ Shop Prices| Coffee \\ Cake \\ Drink| 3.45 \\ 5.35 \\ 2.50| | ||
| ===== Setting Dictionary Values ===== | ===== Setting Dictionary Values ===== | ||
| Line 20: | Line 25: | ||
| {{:token:dictionary-example.png?nolink&568|}} | {{:token:dictionary-example.png?nolink&568|}} | ||
| + | |||
| + | You can list the dictionaries with the [[collection:Dictionaries|Dictionaries]] collection, and you can list all the keys within a dictionary with the [[collection:Dictionary_Keys|Dictionary Keys]] collection. | ||
| + | |||
| + | ===== AppleScript ===== | ||
| + | |||
| + | You can read and write dictionary values from AppleScript. | ||
| + | |||
| + | ```applescript | ||
| + | tell application "Keyboard Maestro Engine" | ||
| + | name of dictionaries | ||
| + | end tell | ||
| + | ``` | ||
| + | |||
| + | ```applescript | ||
| + | tell application "Keyboard Maestro Engine" | ||
| + | dictionary keys of dictionary "First Names" | ||
| + | end tell | ||
| + | ``` | ||
| + | |||
| + | ```applescript | ||
| + | tell application "Keyboard Maestro Engine" | ||
| + | set value of dictionary key "P" of dictionary "First Names" to "Fred" | ||
| + | end tell | ||
| + | ``` | ||
| ===== See Also ===== | ===== See Also ===== | ||
| See also the [[action:Set_Dictionary_Value|Set Dictionary Value]] action, the [[token:Dictionary|%Dictionary%]] token and the [[collection:Dictionaries|Dictionaries]] and [[collection:Dictionary_Keys|Dictionary Keys]] collections. | See also the [[action:Set_Dictionary_Value|Set Dictionary Value]] action, the [[token:Dictionary|%Dictionary%]] token and the [[collection:Dictionaries|Dictionaries]] and [[collection:Dictionary_Keys|Dictionary Keys]] collections. | ||
manual/Dictionaries.txt ยท Last modified: 2021/10/04 03:24 by peternlewis
Page Tools
