Valid for use with hash command: HMI Arguments may be specified as Name:Value Pairs

Implemented on the following platforms: HMi430, Android, Windows

Gets the user to enter an unsigned integer number.

When executes this will generate a pop-up that prompts the Enduser to supply a number. The parameter "Prompt" is a text string that will be presented to the user. Min and Max are optional upper and lower limits. EventHandler is the line label of a subroutine you must supply that handles the response.

The Min and Max limits, if supplied, are enforced such that the enduser cannot “OK” a value that lies outside the limits. If not supplied Min is 0 and Max is 999,999,999.

When your event handler is called, X will indicate if the enduser entered a number (X = True) or clicked Cancel (X = False). If a number was entered, it will be in W.

Sample code snippet:

        #HMI IntInputEvent(p:"Delay time", l:25, h:250, ev:evSetDelay)

...

evSetDelay:     ;Handle user's change of delay time. X is False if user hit cancel. Answer is in W
        RetIfF          ; r/ user cancelled    
        fStoreW         fDelayTime      ;I can just save it, because IntInputEvent already filtered out-of-range values
        Return