User Tools
action:Prompt_for_User_Input
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 | ||
|
action:Prompt_for_User_Input [2019/06/30 21:52] peternlewis |
action:Prompt_for_User_Input [2021/08/23 23:11] peternlewis [Buttons] |
||
|---|---|---|---|
| Line 4: | Line 4: | ||
| You can prompt for variables with text, checkbox, popup menu, or password fields. | You can prompt for variables with text, checkbox, popup menu, or password fields. | ||
| + | |||
| + | {{ promptaction.png?nolink&575x402 | Prompt Action }} | ||
| ===== Example ===== | ===== Example ===== | ||
| Line 9: | Line 11: | ||
| This action: | This action: | ||
| - | {{:action:promptaction.png|}} | + | {{ promptfullaction.png?nolink&575x612 | Prompt Example Action }} |
| Produces this Display: | Produces this Display: | ||
| - | {{:action:promptwindow.png|}} | + | {{ promptwindow.png?nolink&585x505 | Prompt For User Input Window }} |
| ===== Form Fields ===== | ===== Form Fields ===== | ||
| Line 135: | Line 137: | ||
| The [[token:PromptButton|%PromptButton%]] token (v8+) is set to the _name_ of the button pressed, and can be used in actions later in this instance like any other text token. The deprecated _Result Button_ variable is also set to the _name_ of the button pressed. | The [[token:PromptButton|%PromptButton%]] token (v8+) is set to the _name_ of the button pressed, and can be used in actions later in this instance like any other text token. The deprecated _Result Button_ variable is also set to the _name_ of the button pressed. | ||
| - | |||
| - | Note that the system will not allow Keyboard Maestro Engine to see keys typed in its own windows so the [[trigger:Typed String | Typed String triggers]] will not work within Keyboard Maestro Engine windows. | ||
| === How Buttons are Processed === | === How Buttons are Processed === | ||
| - | * The first button (from the top) has a default key of <kbd>⏎</kbd> (RETURN). | + | * The first button (from the top) has a default key of <kbd>⏎</kbd> (RETURN), _unless_ you have assigned the _RETURN_ response to another button using <key>/</key> at the end of a button name. |
| - | * The second button has a default key of either <key>⎋</key> (ESCAPE), or <key>⌘</key><key>.</key> (COMMAND-PERIOD), _unless_ you have assigned the _escape_ response to another button using <key>/</key><key>.</key> at the end of the Button Name. | + | * The second button has a default key of either <key>⎋</key> (ESCAPE), or <key>⌘</key><key>.</key> (COMMAND-PERIOD), _unless_ you have turned off canceling the macro for that button or assigned the _escape_ response to another button using <key>/</key><key>.</key> at the end of a button name. |
| * Any button can _Cancel_ the macro if the "Cancel Macro" checkbox is _checked_ for it. | * Any button can _Cancel_ the macro if the "Cancel Macro" checkbox is _checked_ for it. | ||
| * Other buttons have no default key. | * Other buttons have no default key. | ||
| - | * Whatever button has the key <kbd>⏎</kbd> will be the "Default" button, and will be highlighted in blue appropriately by the system. | + | * Whatever button has the _RETURN_ response will be the Default button, and will be highlighted in blue appropriately by the system. |
| - | * The button shown with a colored outline (usually blue) can be chosen/activated by pressing the SPACE_BAR key. | + | * If you have the system preference “Use keyboard navigation to move focus between controls” enabled, the button shown with a colored outline (usually blue) can be chosen/activated by pressing the _SPACE_ key. |
| **Guidelines for Good Button UI** | **Guidelines for Good Button UI** | ||
| Line 160: | Line 160: | ||
| An update is planned so that if the first button has the Cancel Macro flag, then it is not the default (by default), and if the second button does not have the Cancel Macro flag, then it does not get the Escape/Command-, key (by default). | An update is planned so that if the first button has the Cancel Macro flag, then it is not the default (by default), and if the second button does not have the Cancel Macro flag, then it does not get the Escape/Command-, key (by default). | ||
| + | |||
| + | ===== Notes ===== | ||
| + | |||
| + | Note that the system will not allow Keyboard Maestro Engine to see keys typed in its own windows so the [[trigger:Typed String]] triggers will not work within Keyboard Maestro Engine windows. | ||
| Note that the system really really wants a "default" button, and if you do not give it one, it will choose one for you. | Note that the system really really wants a "default" button, and if you do not give it one, it will choose one for you. | ||
action/Prompt_for_User_Input.txt · Last modified: 2023/09/13 00:04 by peternlewis
Page Tools
