system.gui.inputBox

Description

Opens up a popup input dialog box. This dialog box will show a prompt message, and allow the user to type in a string. When the user is done, they can press "OK" or "Cancel". If OK is pressed, this function will return with the value that they typed in. If Cancel is pressed, this function will return the value None.

Syntax

system.gui.inputBox(message, defaultText)

Parameters

String message - The message to display for the input box.

String defaultText - The default text to initialize the input box with.

Returns

String - The string value that was entered in the input box.

Scope

Client

Examples

This could go in the mouseClicked event of a label to allow the user to change the label's text.

txt = system.gui.inputBox("Enter text:", event.source.text)

if txt != None:

   event.source.text = txt