system.gui.showNumericKeypad

This function is used in Python Scripting.

Description

Displays a modal on-screen numeric keypad, allowing for arbitrary numeric entry using the mouse, or a finger on a touch screen monitor. Returns the number that the user entered.

Client Permission Restrictions

This scripting function has no Client Permission restrictions.

Syntax

system.gui.showNumericKeypad(initialValue, [fontSize], [usePasswordMode])

Parameters

Type	Parameter	Description
Number	initialValue	The value to start the on-screen keypad with.
Integer	fontSize	The font size to display in the keypad. [optional]
Boolean	usePasswordMode	If True, display a * for each digit. [optional]

Returns

Number - The value that was entered in the keypad.

Scope

Vision Client

Code Examples

Example #1

# This function is a holdover for backwards compatibility. Input components now know when the Client is in Touch Screen mode and respond accordingly. 
# This script would go in the MouseClicked or MousePressed action of a Text field or Numeric Text field.
  
# For Integer Numeric Text field:
if system.gui.isTouchscreenModeEnabled():
   event.source.intValue = system.gui.showNumericKeypad(event.source.intValue)
  
# For Double Numeric Text field:
if system.gui.isTouchscreenModeEnabled():
   event.source.doubleValue = system.gui.showNumericKeypad(event.source.doubleValue)
  
# For Text field:
# Notice the str() and int() functions used to convert the text to a number and
# vice versa.
# str() and int() are built-in Jython functions
if system.gui.isTouchscreenModeEnabled():
   event.source.text = str(system.gui.showNumericKeypad(int(event.source.text)))