UI.Message text:RichText, [title:Str, buttons:Str]

Display a message. This displays a standard message box with the specified text and title, and the specified buttons. For example,

 UI.Message "Choose a color", "Question", "Red Green Blue"

displays a message box with three buttons: "Red", "Green", and "Blue".

The buttons can be activated by hitting their first letter. In addition, the Enter key activates the first button, ESC activates the last one.

This command returns the index of the pressed button in UI.Result. For example, if the user chose "Red" above, UI.Result will have the value 1 afterwards.

In text mode, displays text and heading, and a list of first letters of the buttons, and waits for a matching keystroke.

The last two parameters are optional and default to "Message" and "OK".

This command differs from MessageBox in that it modifies UI.Result, and waits for a keystroke in text mode.

Version Differences: PCC 1.x allows up to 10 buttons; PCC2 has no such limit (but you are adviced to keep the number of buttons and the length of the texts short anyway).

Since: PCC 1.0.9, PCC2 1.99.9

See also: MessageBox, UI.Input, Global Commands