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 22:04] peternlewis |
action:Prompt_for_User_Input [2021/10/14 01:04] peternlewis [Form Fields] |
||
|---|---|---|---|
| Line 1: | Line 1: | ||
| - | ====== Prompt For User Input ====== | + | ====== Prompt For User Input Action ====== |
| _Prompt For User Input_ allows you to design a form that will ask for user input, storing the results in [[manual:Variables|Keyboard Maestro Variables]]. | _Prompt For User Input_ allows you to design a form that will ask for user input, storing the results in [[manual:Variables|Keyboard Maestro Variables]]. | ||
| Line 5: | Line 5: | ||
| 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 }} | + | {{ promptaction.png?nolink&600 | Prompt For User InputAction }} |
| - | ===== Example ===== | + | This action produces this Display: |
| - | This action: | + | {{ promptwindow.png?nolink&583 | Prompt For User Input Window }} |
| - | + | ||
| - | {{ promptfullaction.png?nolink&575x612 | Prompt Example Action }} | + | |
| - | + | ||
| - | Produces this Display: | + | |
| - | + | ||
| - | {{ promptwindow.png?nolink&585x505 | Prompt For User Input Window }} | + | |
| ===== Form Fields ===== | ===== Form Fields ===== | ||
| Line 24: | Line 18: | ||
| |Form Title|Display Only|Identify the Main Purpose of the Form| | |Form Title|Display Only|Identify the Main Purpose of the Form| | ||
| |Prompt|Display only|Optionally provide instructions and/or display Variables| | |Prompt|Display only|Optionally provide instructions and/or display Variables| | ||
| - | |Keyboard Maestro Variables|Display/Edit|**Optionally Allow User Input to Enter, Change, or Accept default value**\\ • Variables may be displayed as "Text (Single Line)", "Popup Menu", or Checkbox\\ • "Text Area" and "Radio Buttons" are _not_ supported| | + | |Keyboard Maestro Variables|Display/Edit|Optionally allow you to input variable values. Variables may be displayed as *Text* (Single Line, or Password), *Popup Menu*, or *Checkbox*, *Slider* (v10.0+), *Color* (v10.0+), Date or Time or Date&Time (v10.0+)| |
| - | |Buttons|Standard Mac|Allow User to accept, cancel, or provide other responses you may define| | + | |Buttons|Standard Mac|Allow you to accept, cancel, or provide other responses you may define| |
| ==== Form Title ==== | ==== Form Title ==== | ||
| Line 140: | Line 134: | ||
| === 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 “/” 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 “/.” 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 174: | Line 168: | ||
| * [[action:Prompt_With_List|Prompt With List]] action | * [[action:Prompt_With_List|Prompt With List]] action | ||
| * [[action:Prompt_for_File|Prompt for File]] action | * [[action:Prompt_for_File|Prompt for File]] action | ||
| + | * [[action:Prompt_for_Screen_Rectangle|Prompt for Screen Rectangle]] action | ||
| * [[action:Custom_HTML_Prompt|Custom HTML Prompt]] action | * [[action:Custom_HTML_Prompt|Custom HTML Prompt]] action | ||
| * [[action:Show_Palette_of_Macros|Show Palette of Macros]] action | * [[action:Show_Palette_of_Macros|Show Palette of Macros]] action | ||
action/Prompt_for_User_Input.txt · Last modified: 2023/09/13 00:04 by peternlewis
Page Tools
