Syntax

  KeyPad( "strTagName", optStrKeyboardName, optNumIsPassword, optStrHint, optNumMin, optNumMax, optNumESign, optStrConfirmation )  

strTagName

The name of the tag to which the Virtual Keyboard will write.

This name must be enclosed in quotes; if it is not, then the project will try to get the contents of the tag.

optStrKeyboardName

Type of Virtual Keyboard that will be launched (e.g., AlphaNumeric, EnhKeypad, or Keypad ). If this parameter is omitted, then the default Virtual Keyboard will be launched.

optNumIsPassword

If this parameter is set with any value different from 0 (zero), the characters typed in the Virtual Keyboard will appear as asterisks (“*“). This option is useful when the user is typing a password.

optStrHint

The value specified for this parameter is displayed in the title bar of the Virtual Keyboard window, if the Show Hint option is selected in the project settings.

optNumMin, optNumMax

Minimum and maximum numeric values for the Tag when using the Keypad keyboard type, if the Show MIN/MAX fields option is selected in the project settings. (These values are ignored for all other keyboard types.) These parameters are optional, but you must specify both to have them implemented. If you specify only one parameter — for example, Min but not Max — then it will be ignored.

optNumESign

If this parameter is set with any value different from 0 (zero), then the user will be prompted to log on to complete the input and the action will be noted in the log.

optStrConfirmation

The value specified for this parameter is displayed in a confirmation dialog that the user must acknowledge to complete the input.

Note: Confirmation cannot be automated or bypassed; only an actual key press or mouse click by the user will acknowledge the dialog.

This is an optional parameter. If no value is specified, then no dialog is displayed.

Returned value

Examples