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:53] peternlewis |
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 21: | Line 26: | ||
{{:token:dictionary-example.png?nolink&568|}} | {{:token:dictionary-example.png?nolink&568|}} | ||
- | ===== See Also ===== | + | 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. |
- | === Actions === | + | ===== AppleScript ===== |
- | * [[action:Set_Dictionary_Value|Set Dictionary Value]] action | + | You can read and write dictionary values from AppleScript. |
- | === Collections === | + | ```applescript |
+ | tell application "Keyboard Maestro Engine" | ||
+ | name of dictionaries | ||
+ | end tell | ||
+ | ``` | ||
- | * [[collection:Dictionaries|Dictionaries]] collection | + | ```applescript |
- | * [[collection:Dictionary_Keys|Dictionary Keys]] collection | + | tell application "Keyboard Maestro Engine" |
+ | dictionary keys of dictionary "First Names" | ||
+ | end tell | ||
+ | ``` | ||
- | === Forum === | + | ```applescript |
+ | tell application "Keyboard Maestro Engine" | ||
+ | set value of dictionary key "P" of dictionary "First Names" to "Fred" | ||
+ | end tell | ||
+ | ``` | ||
- | - [[https://forum.keyboardmaestro.com/search?q=Dictionary|Keyboard Maestro Forum topics about Dictionaries]] | + | ===== 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. |