Skip to main content
Version: 8.1

system.gui.showTouchscreenKeyboard

This function is used in Python Scripting.

Description

Displays a modal on-screen keyboard, allowing for arbitrary text entry using the mouse, or a finger on a touchscreen monitor. Returns the text that the user entered.

Client Permission Restrictions

This scripting function has no Client Permission restrictions.

Syntax

system.gui.showTouchscreenKeyboard(initialText, [fontSize], [passwordMode])

Parameters

TypeParameterDescription
StringinitialTextThe text to start the on-screen keyboard with.
IntegerfontSizeThe font size to display in the keyboard. [optional]
BooleanpasswordModeA True value will activate password mode, where the text entered is not echoed back in cleartext. [optional]

Returns

String - The text that was entered in the on-screen keyboard.

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 would go in the MouseClicked or MousePressed action of a Text Field or similar component.

if system.gui.isTouchscreenModeEnabled():
event.source.text = system.gui.showTouchscreenKeyboard(event.source.text)

Keywords

system gui showTouchscreenKeyboard, gui.showTouchscreenKeyboard