Table of Contents
Advertisement
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
Title
MaxDigits
Decimal
Result
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
3 - 40
Description
Specify the title of the displayed number pad. Its a pointer to a null terminated
character string.
Maximum digits to be displayed (including decimal point)
The amount of digits allowed to the right of the decimal point
Returns a variable length text string containing the number entered
Advertisement
Table of Contents
