Project

General

Profile

$input » History » Revision 2

Revision 1 (Per Amundsen, 08/14/2015 12:59 PM) → Revision 2/11 (Per Amundsen, 06/13/2016 07:46 AM)

_Added in 1.9.0_ 

 *$input(prompt,[options],[window],[title],[text])* 

 Prompts the user for input and returns the result. 

 *parameters* 

 prompt - Question text. 
 [options] - (optional) 
 <pre> 
 e - Show show input Editbox. 
 p - Show show input password Editbox. 
 o - Show only a OK button. TODO 
 y - Show Yes/No buttons. TODO 
 n - Show Yes/No/Cancel buttons. TODO 
 r - Show Retry/Cancel buttons. TODO 
 v - Return [[$ok]], [[$yes]], [[$no]], [[$cancel]] for buttons. TODO 
 g - Right-align buttons. TODO 
 b - Disables buttons for a second when dialog is displayed. TODO 
 f - TODO 
 i - Show the information icon. TODO 
 q - Show the question icon. TODO 
 w - Show the warning icon. TODO 
 h - Show the error icon. TODO 
 d - Play the system sound associated with the icon. TODO 
 s - Indicates that [window] name has been specified. TODO 
 a - TODO ? 
 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]]. TODO 
 m - TODO 
 </pre> 

 [window] - Window name to associate the dialog with. TODO 
 [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>