Skip to end of metadata
Go to start of metadata

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 "typed".

Client Permission Restrictions

This scripting function has no Client Permission restrictions.

Syntax

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

  • Parameters

String initialText - The text to start the on-screen keyboard with.

int fontSize - The font size to display in the keyboard. [optional]

boolean passwordMode - True (1) to activate password mode, where the text entered isn't echoed back clear-text. [optional]

  • Returns

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

  • Scope

Client

Code Examples
Code Snippet
# This function is a holdover for backwards compatibility. Input components now know when the client is in touchscreen 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)
  • No labels