【 utils.multilistbox 】
格式:
utils.multilistbox (msg, title, tbl, defaults)
中文:
utils.multilistbox (提示內容, 標題, 選項列表, 預選項)
說明:
顯示可以多選的選擇對話框(但要按Shift才能多選)。如果使用者取消
了對話框,或者沒有做任何選擇,函數會回傳 nil。否則會回傳被選項對應的
索引值。
函數至少需要一個提示文字(msg)和一個選項列表(tbl)。
1.msg :提示文字(最多 1000 個字元)。
2.title :對話框的標題,如果為 nil 的話,預設值為「MUSHclient」
(最多 100 個字元)。
3.tbl :預選項列表,詳見下面的描述
4.default:選擇對話框的預設值(初始)值。預設值為不選擇任何項。
函數回傳值為被選項在選項表中對應的索引值。如果使用者取消了對話框
,或者沒有做任何選擇,函數會回傳 nil。
第三個參數是一個預選項列表。函數顯示對話框的時候顯示的是表中每一
項的值,回傳的卻是被選項對應的索引值。列表框的值會自動以字母的升冪排
序。
第四個參數是對話框顯示時預設值選中的項。對前兩個函數它是一個字串
或者數字,對第三個函數,它是一個表,形如 {apple = true, 3}。
注意:由於列表項會對值排序,所以順序未必會跟設定項目一樣。
由於函數回傳的是被選項對應的索引值,所以你可以透過這個索引值直接
得到被選擇的項。
索引值和值可以是字串或者數字,MUSHclient 會自動判斷它們的類型(例如
"10" 和 10 被認為是兩個不同的索引值)。
範例:
--==-==--==-==--==-==--==-==--==-==--==-==--==-==--==-==--==-==--==-==--==-==--