From WikiChip
Difference between revisions of "mirc/identifiers/$input"
< mirc‎ | identifiers

(Parameters)
(4 intermediate revisions by the same user not shown)
Line 1: Line 1:
 
{{mirc title|$input identifier}}'''$input''' is used to request immediate user-input.
 
{{mirc title|$input identifier}}'''$input''' is used to request immediate user-input.
  
'''Note:''' This replaces the deprecated '''$?''' identifier.
+
'''Note:''' This replaces the deprecated {{mIRC|$?}} identifier.
  
  
Line 35: Line 35:
 
The options, window, title, and text are optional parameters.
 
The options, window, title, and text are optional parameters.
  
By default, buttons return $true or $null, same as $?. If there is an input editbox, the ok/yes buttons always return the contents of the editbox.
+
By default, buttons return $true or $null, same as $?. If there is an input editbox, the ok/yes buttons always return the contents of the editbox (unless '''f''' switch is used).
 +
 
 +
For the '''options''' parameter, you can also use a number as a combination of value added together, which is how $input was originally working:
 +
* '''1'''  - show input editbox (equivalent of the 'e' switch)
 +
* '''2'''  - show input password editbox (equivalent of 'p' switch)
 +
* '''4'''  - ok button (equivalent of 'o')
 +
* '''8'''  - yes/no buttons ('y')
 +
* '''16''' - yesnocancel buttons ('n')
 +
* '''32''' - return $ok, $yes, $no, $cancel for buttons. ('v')
 +
* '''64''' - show the info icon ('i')
 +
* '''128''' - show the question icon ('q')
 +
* '''256''' - show the warning icon ('w')
 +
* '''512''' - show the hand icon ('h')
 +
 
 +
$input(sup,5) is equivalent to $input(sup,eo)
  
 
'''Note:''' This identifier '''cannot''' be used in a remote event. One way around this is to use a {{mirc|/timer}} to initiate an input request after the script ends. Another way around it is to use {{mirc|/signal}} to trigger an {{mirc|on signal}} event.
 
'''Note:''' This identifier '''cannot''' be used in a remote event. One way around this is to use a {{mirc|/timer}} to initiate an input request after the script ends. Another way around it is to use {{mirc|/signal}} to trigger an {{mirc|on signal}} event.

Revision as of 11:29, 21 September 2018

$input is used to request immediate user-input.

Note: This replaces the deprecated $? identifier.


Synopsis

$input(prompt,options,window,title,text)

Prompts the user for input and returns the result.

Parameters

  • prompt - text displayed inside the input dialog window. The input dialog is extended vertically to display the prompt message if it is very long. You can also make text in the prompt message appear on different lines by using $crlf to separate lines.
  • options - Options can be a combination of the following:
  • e - show input editbox
  • p - show input password editbox
  • o - ok button
  • y - yes no buttons
  • n - yes no cancel buttons
  • r - 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
  • iqwh - show the info, question, warning, and halt icons respectively.
  • d - play system sound associated with icon.
  • s - indicates that window name has been specified
  • a - activate dialog
  • u - use current active window as parent window
  • kN - an N second timeout value. On timing out, $timeout is returned if v is specified, no value if e is specified, and $false otherwise.
  • m - indicates that multiple text parameters have been specified. They will be displayed in a combobox. The first text item is the default item (a reference to an item in the list), the rest are the items in the list.
  • window - if option s is specified, the name of the window to be used as parent window.
  • title - the titlebar text.
  • text - default text placed in the input editbox

The options, window, title, and text are optional parameters.

By default, buttons return $true or $null, same as $?. If there is an input editbox, the ok/yes buttons always return the contents of the editbox (unless f switch is used).

For the options parameter, you can also use a number as a combination of value added together, which is how $input was originally working:

  • 1 - show input editbox (equivalent of the 'e' switch)
  • 2 - show input password editbox (equivalent of 'p' switch)
  • 4 - ok button (equivalent of 'o')
  • 8 - yes/no buttons ('y')
  • 16 - yesnocancel buttons ('n')
  • 32 - return $ok, $yes, $no, $cancel for buttons. ('v')
  • 64 - show the info icon ('i')
  • 128 - show the question icon ('q')
  • 256 - show the warning icon ('w')
  • 512 - show the hand icon ('h')

$input(sup,5) is equivalent to $input(sup,eo)

Note: This identifier cannot be used in a remote event. One way around this is to use a /timer to initiate an input request after the script ends. Another way around it is to use /signal to trigger an on signal event.

Examples

alias testme {
  echo -a $input(Type something for me,e)
}

Echoes whatever the user types into the input field to the active window.

alias testme {
  echo -a $input(Enter Password:,p)
}

Does the same as the first example, except while the user is typing, the characters are replaced by password characters. The typed value, however, is visibly legible when it is echoed to the active window.

alias testme {
  echo -a $input(Do you like chocolate?,y)
}

Pops up an input request asking if the user likes chocolate. If they click Yes, it echoes $true to the active window; otherwise, it echoes $false.

See also

v · d · e mIRC identifier list

$ $$, $, $0, $1-, $!, $&, $*, $+, $++, $?

A $abook, $abs, $acos, $active, $activecid, $activewid, $adate, $address, $addtok, $addtokcs, $agent, $agentname, $agentstat, $agentver, $alias, $and, $anick, $ansi2mirc, $aop, $appactive, $appstate, $asc, $asctime, $asin, $atan, $atan2, $auto, $avoice, $away, $awaymsg, $awaytime

B $banlist, $banmask, $base, $beta, $bfind, $bindip, $bitoff, $biton, $bits, $bnick, $bvar, $bytes

C $calc, $caller, $cancel, $cb, $cd, $ceil, $chan, $chanmodes, $channel, $chantypes, $chat, $chr, $cid, $clevel, $click, $cmdbox, $cmdline, $cnick, $color, $colour, $com, $comcall, $comchan, $comchar, $comerr, $compact, $compress, $comval, $cos, $cosh, $count, $countcs, $cr, $crc, $creq, $crlf, $ctime, $ctimer, $ctrlenter

D $date, $day, $daylight, $dbuh, $dbuw, $dccignore, $dccport, $dde, $ddename, $debug, $decode, $decompress, $deltok, $devent, $dialog, $did, $didreg, $didtok, $didwm, $dir, $disk, $dlevel, $dll, $dllcall, $dname, $dns, $donotdisturb, $dqwindow, $duration

E $ebeeps, $editbox, $email, $emailaddr, $encode, $envvar, $error, $eval, $evalnext, $event, $eventid, $eventparms, $exists, $exiting

F $false, $feof, $ferr, $fgetc, $file, $filename, $filtered, $find, $finddir, $finddirn, $findfile, $findfilen, $findtok, $findtokcs, $fline, $flinen, $floor, $font, $fopen, $fread, $fromeditbox, $fserv, $fserve, $fulladdress, $fulldate, $fullname, $fullscreen

G $get, $getdir, $getdot, $gettok, $gmt, $group

H $halted, $hash, $height, $hfile, $hfind, $hget, $highlight, $hmac $hmatch, $hnick, $host, $hotline, $hotlinepos, $hotlink, $hotp, $hregex, $hypot

I $iaddress, $ial, $ialchan, $ibl, $idle, $iel, $ifmatch, $ifmatch2, $ignore, $iif, $iil, $inellipse, $ini, $initopic, $inmidi, $inmode, $inmp3, $inpaste, $inpoly, $input, $inrect, $inroundrect, $insong, $insongpause, $instok, $int, $intersect, $inwave, $inwho, $ip, $iptype, $iql, $isadmin, $isalias, $isbit, $isdde, $isdir, $isfile, $isid, $islower, $istok, $istokcs, $isupper, $isutf

K $keychar, $keyrpt, $keyval, $knick

L $lactive, $lactivecid, $lactivewid, $left, $leftwin, $leftwincid, $leftwinwid, $len, $level, $lf, $line, $lines, $link, $lock, $locked, $lof, $log, $log10, $logdir, $logstamp, $logstampfmt, $longfn, $longip, $lower, $ltimer

M $maddress, $mask, $matchkey, $matchtok, $matchtokcs, $maxlenl, $maxlenm, $maxlens, $md5, $me, $menu, $menubar, $menucontext, $menutype, $mid, $mididir, $mircdir, $mircexe, $mircini, $mkfn, $mklogfn, $mknickfn, $mnick, $mode, $modefirst, $modelast, $modespl, $mouse, $mousecx, $mousecy, $mousedx, $mousedy, $mousekey, $mouselb, $mousex, $mousey, $mousewin, $mp3, $mp3dir, $msfile, $msgstamp, $msgtags

N $N, $naddress, $network, $newnick, $nhnick, $nick, $nickmode, $no, $nofile, $nopath, $nopnick, $noqt, $not, $notags, $notify, $null, $numeric, $numtok, $nvnick

O $ok, $online, $onlineserver, $onlinetotal $onpoly, $opnick, $or, $ord, $os

P $parmN, $parms, $parseline, $parsetype, $parseutf, $passivedcc, $pi, $pic, $play, $pnick, $portable, $portfree, $pos, $poscs, $prefix, $prop, $protect, $puttok

Q $qt, $query

R $r, $raddress, $rand, $rands, $rawbytes, $rawmsg, $read, $readini, $readn, $regbr, $regerrstr, $regex, $regml, $regmlex, $regsub, $regsubex, $remote, $remove, $removecs, $remtok, $remtokcs, $replace, $replacecs, $replacex, $replacexcs, $reptok, $reptokcs, $result, $rgb, $right, $rnick, $round

S $samepath, $scid, $scon, $script, $scriptdir, $scriptline, $sdir, $send, $server, $serverip, $servertarget, $sfile, $sha1, $sha256, $sha384, $sha512, $shortfn, $show, $signal, $sin, $sinh, $site, $sline, $snick, $snicks, $snotify, $sock, $sockbr, $sockerr, $sockname, $sorttok, $sorttokcs, $sound, $speak, $sqrt, $sreq, $ssl, $sslcertsha1, $sslcertsha256, $sslcertvalid, $ssldll, $ssllibdll, $sslready, $sslversion, $starting, $status, $str, $strip, $stripped, $style, $submenu, $switchbar, $sysdir

T $tan, $tanh, $target, $tempfn, $ticks, $time, $timeout, $timer, $timestamp, $timestampfmt, $timezone, $tip, $tips, $titlebar, $token, $toolbar, $topic, $totp, $treebar, $true, $trust

U $ulevel, $ulist, $unsafe, $upper, $uptime, $url, $usermode, $utfdecode, $utfencode

V $v1, $v2, $var, $vc, $vcmd, $vcmdstat, $vcmdver, $version, $vnick, $vol

W $wavedir, $wid, $width, $wildsite, $wildtok, $wildtokcs, $window, $wrap

X $xor

Y $yes

Z $zip

= =$nick