Release notes for MUSHclient version 3.70

1. Changed the documentation slightly to describe the difference between "print" and "Note" when using Lua.

2. Remove "Test Command" and "Test Trigger" from the RH mouse-click pop-up menu, if you click in the command window, as they are no longer implemented.

3. Added new Lua script function: utils.msgbox

This lets you display a Windows message box (very similar to MsgBox in VBscript). The intention is to allow you to display (in a small dialog box), information of an urgent nature, or ask a yes/no type question.

The calling sequence is:

result = utils.msgbox ( msg, title, type, icon, default )

The only required argument is the message text itself, the others default to their first possible value. The first 4 arguments are string arguments, the last is a number.

msg = message to display (max 1000 characters)

title = title of box - if nil, defaults to "MUSHclient" (max 100 characters)

type = type of box (must be in lower case and exactly as shown here):

"ok" - The message box contains one push button: OK. This is the default.

"!" - An exclamation-point icon appears in the message box. This is the default.
"?" - A question-mark icon appears in the message box.
"i" - An icon consisting of a lowercase letter i in a circle appears in the message box.
"." - A stop-sign icon appears in the message box.

default = default button (1 - 3)

This sets the default button (the one with the focus) to be either button 1, 2 or 3. The default is the first button.

This lets you display a Windows message box and accept a free-format reply (very similar to InputBox in VBscript). The intention is to allow you to display (in a small dialog box) a question and accept a typed response.

The calling sequence is:

result = utils.inputbox ( msg, title, default )

The only required argument is the message text itself.

msg = message to display (max 1000 characters)

title = title of box - if nil, defaults to "MUSHclient" (max 100 characters)

These functions display a dialog box with a predetermined list of items for the user to choose from. If the user cancels the dialog box, or does not make a selection, nil is returned. Otherwise the key of the selected item is returned.

utils.choose - displays a dialog box with a combo-box in it (drop-down list)

utils.listbox - displays a dialog box with a list control in it

The utils.listbox would be more suitable for longer lists, but that is probably partly personal preference.

The calling sequence is:

result = utils.choose ( msg, title, t, default )

The only required arguments are the message text and the table of choices (t).

msg = message to display (max 1000 characters)

title = title of box - if nil, defaults to "MUSHclient" (max 100 characters)

t - table of key/value pairs, as described below

default = default key - defaults to no selection

Return value = the key of what they selected, or nil if cancelled, or nothing selected.

The third argument is a table of key/value pairs. The value is displayed, however the corresponding key is returned. The values are automatically sorted into ascending alphabetic order.

The fourth argument is the key (string or number) which corresponds to the wanted default selection. If it does not correspond to any key in the table then no item will be selected.