User Tools
action:Prompt_With_List
Differences
This shows you the differences between two versions of the page.
| Both sides previous revision Previous revision Next revision | Previous revision | ||
|
action:Prompt_With_List [2020/01/08 22:43] JMichaelTX [Prompt With List] |
action:Prompt_With_List [2022/09/27 02:37] (current) peternlewis |
||
|---|---|---|---|
| Line 1: | Line 1: | ||
| - | ====== Prompt With List ====== | + | ====== Prompt With List Action ====== |
| The //Prompt With List// action (v8+) lets you select from a list of values. The values should be placed on separate lines, and can come from a clipboard, variable, file or text within the action. | The //Prompt With List// action (v8+) lets you select from a list of values. The values should be placed on separate lines, and can come from a clipboard, variable, file or text within the action. | ||
| Line 7: | Line 7: | ||
| You can include a title (which is only displayed when the search field is empty), as well as a default search string (v8.1+). You can also configure the width of the window (narrow, normal, wide, automatic) and whether to allow multiple selections (v8.1+) and whether to sort the entries (v9.0+). | You can include a title (which is only displayed when the search field is empty), as well as a default search string (v8.1+). You can also configure the width of the window (narrow, normal, wide, automatic) and whether to allow multiple selections (v8.1+) and whether to sort the entries (v9.0+). | ||
| - | If a single entry is returned, it is returned by itself (no newline character). If multiple entries are returned, they will be returned as multiple lines, each followed by a newline character (8.1+). | + | If a single entry is returned, it is returned by itself (no newline character). If multiple entries are returned, they will be returned as multiple lines, each followed by a newline character (v8.1+). |
| - | If there is no title and no search string and less than 100 items, then all the items will be shown. Otherwise only matching items will be shown until you search for something. To display all of the items even when more than 100 items, just enter "all:" in the search box. | + | If there is no title and no search string and less than 100 items, then all the items will be shown in the scrolling list. Otherwise no items will be shown until you search for something and then matching items will be shown in the list. To display all of the items even when more than 100 items, enable the Always Show All Entries option in the gear BUTTON{{{⚙}}} menu (v10.2+). |
| The values are displayed in a Spotlight-like window, similar to the [[action:Trigger_Macro_by_Name|Trigger Macro by Name]] action. | The values are displayed in a Spotlight-like window, similar to the [[action:Trigger_Macro_by_Name|Trigger Macro by Name]] action. | ||
| Line 16: | Line 16: | ||
| The selected item will be saved back to the source of the list, or to a specified clipboard, variable or file. | The selected item will be saved back to the source of the list, or to a specified clipboard, variable or file. | ||
| + | |||
| + | If you press Escape, the action will fail and no result will be saved. By default the macro will be canceled and you will be notified of the failure, but you can adjust that in the gear BUTTON{{{⚙}}} menu. | ||
| + | |||
| + | The resulting items will be trimmed of leading or trailing white space by default, but you can (v10.2+) disable this by turning off Trim Lines in the gear BUTTON{{{⚙}}} menu. | ||
| ==== How to Store a Different Value than Displayed ==== | ==== How to Store a Different Value than Displayed ==== | ||
| Line 37: | Line 41: | ||
| * [[action:Prompt_for_User_Input|Prompt for User Input]] | * [[action:Prompt_for_User_Input|Prompt for User Input]] | ||
| * [[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:Get_Touch_Bar_Selection|Get Touch Bar Selection]] action | * [[action:Get_Touch_Bar_Selection|Get Touch Bar Selection]] action | ||
action/Prompt_With_List.1578541432.txt.gz · Last modified: 2020/01/08 22:43 by JMichaelTX
Page Tools
