Hand Held Products PadCom TT1500, User Manual

Page: 60 / 132

3 - 40
padPromptNumber
Displays a numeric keypad and returns the entered number. The user is prompted
to enter a numeric value. The prompt includes “ENTER”, “CLEAR”, ”C”, “UNDO”,
and “CANCEL” buttons. “ENTER” accepts the numeric entry. “CLEAR” and “C”
both clear the numeric entry. “UNDO” removes the last numeric digit entered.
“CANCEL” exits the prompt. Unlike
padPromptNum , the numeric value can be a
decimal value and can have up to 17 digits, including the optional decimal point,
and is not returned as a 16-bit value. Instead the result is returned as a text string
containing the digits entered and a decimal point (if any). If
Decimal equals 0, then
no decimal point is allowed. If Decimal equals 2, then a total of two digits to the
right of the decimal point are allowed; a value of 3 allows three digits to the right of
the decimal point, and so on. The illustration depicts the layout of a number pad
with the decimal point.
Syntax
BOOL padPromptNumber (
char *Title,
WORD MaxDigits,
WORD Decimal,
char *Result
)
Parameter Description
Title Specify the title of the displayed number pad. Its a pointer to a null terminated
character string.
MaxDigits Maximum digits to be displayed (including decimal point)
Decimal The amount of digits allowed to the right of the decimal point
Result Returns a variable length text string containing the number entered
Returns
Returns TRUE upon success, FALSE otherwise.
See Also
padPromptHexNumber, padPromptNum, padPromptReset, padPromptSignature, padPromptString,
padPromptTimeout
padPromptReset
This command resets/cancels all prompts. This command causes the prompt to act as though the “CANCEL” button on the
prompt has been pressed. If this command is called, and a prompt is currently being displayed (such as
padPromptNumber ), the prompt is immediately removed from the screen. This is used in cases where the prompt needs
to be removed if the user has not acted on the prompt within a given amount of time. For example, suppose that
padPromptNumber is called and a number prompt is now on the display. Three minutes pass and the user has not
responded to the prompt. You can use padPromptReset to stop the current prompt and go on to something else.
Syntax
BOOL padPromptReset(
void
)
Returns
Returns TRUE upon success, FALSE otherwise.
See Also
padPromptHexNumber, padPromptNum, padPromptNumber, padPromptSignature, padPromptString,
padPromptTimeout