UI.InputNumber title:Str, [min:Int, max:Int,
  current:Int, help:Any]

Number input. This command prompts for a number, using the standard number input window.

The parameters are

  • title: the title/prompt shown in the dialog.
  • min,max: the acceptable range of numbers (defaults to 0..10000).
  • current: the current value (defaults to 0).
  • help: help page to associate with dialog.

Only the first parameter is mandatory.

The result will be returned in UI.Result. It will be an integer within the requested range, or EMPTY if the user canceled the dialog.

For example, to change a ship's warp factor, you could use

 UI.InputNumber "Warp", 0, 9, Speed$
 SetSpeed UI.Result

(Note that SetSpeed is implicitly ignored if its parameter is EMPTY).

This command currently does not work in text mode.

Since: PCC 1.1.16, PCC2 1.99.9

See also: Global Commands