$input » History » Revision 9
Revision 8 (Per Amundsen, 01/23/2017 03:59 PM) → Revision 9/11 (Per Amundsen, 02/01/2017 01:12 AM)
_Added in 1.9.0_ *$input(prompt,[options],[window],[title],[text])* Prompts the user for input and returns the result. _See also [[$yes]], [[$no]], [[$ok]], [[$cancel]], [[$timeout]]._ _Can be prefixed with # to ensure the resulted text starts with a channel prefix._ *parameters* prompt - Question text. [options] - (optional) e - Show input Editbox. p - Show input password Editbox. o - Show only a OK button. y - Show Yes/No buttons. n - Show Yes/No/Cancel buttons. r - Show Retry/Cancel buttons. v - Return [[$ok]], [[$yes]], [[$no]], [[$cancel]] for buttons. g - Right-align buttons. b - Disables buttons for a second when dialog is displayed. f - Return [[$no]]/[[$cancel]] for edit/combo boxes if no/cancel is pressed. TODO i - Show the information icon. q - Show the question icon. w - Show the warning icon. h - Show the error icon. c - Show the recycle bin icon. t - Show the favorites icon. d - Play the system sound associated with the icon. s - Indicates that [window] name has been specified. a - Unminimize and focus the parent form. u - use current active window as parent window kN - Close/timeout the dialog after N seconds. On timing out, [[$timeout]] is returned if v is specified, otherwise [[$false]]. m - Indicates that multiple text parameters have been specified. They will be displayed in a combobox. [window] - Window name to associate the dialog with. [title] - The Titlebar text [text] - The default text placed in the input Editbox. *Example* <pre> ; Ask for a name and print it. //echo -ag $input(What is your name?, Question) </pre>