tera term的TTL脚本命令之listbox

listbox

显示一个列表框，并向用户询问项目。

listbox <message> <title> <string array> [<selected>]

listbox <消息> <标题> <字符串数组> [<可选的>]

 

参数

字符串<message>

它显示在列表框中。

字符串<title>

它作为列表框的标题显示。

数组<string array>

它显示为列表框中的项目。

整数<selected> (version 4.89 or later)

通过指定数组的从零开始的索引来选择第一项。 这个参数是可选的。

返回值

系统变量 <result>

如果用户选择项目中的一个，则将其设置为从0到N-1。
如果用户取消，则将其设置为-1。

使用说明

listbox宏命令显示<string array>数组的所有选定项。
如果<string array>被定义为比所选数字更大的条目，如下所示，最后将显示空字符串。

strdim msg 4
msg[0] = 'Banana' 
msg[1] = 'Apple' 
msg[2] = 'Orange'
listbox 'Select your favorite food.' 'Confirmation' msg

; displays 4 items
Banana
Apple
Orange
[Empty string]

(version 4.89 or later)

指定<selected>参数时，可以首先选择列表框的项目。
如果省略该参数，则默认值为0。

例子

strdim msg 3
msg[0] = 'Banana' 
msg[1] = 'Apple' 
msg[2] = 'Orange'
listbox 'Select your favorite food.' 'Confirmation' msg
sprintf2 var "%d" result
messagebox var "result"
; result
;   -1: Cancel
;    0: Banana
;    1: Apple
;    2: Orange

strdim msg 7
msg[0] = 'Sunny' 
msg[1] = 'Cloudy' 
msg[2] = 'Rainy'
msg[3] = 'Windy'
msg[4] = 'Snowy'
msg[5] = 'Foggy'
msg[6] = 'Unknown'
; The seventh entry is selected by default.
listbox "How's today's weather?" 'Confirmation' msg 6
sprintf2 var "%d" result
messagebox var "result"