| GUI.SetEchoChar | Part of GUI module |
| Syntax | GUI.SetEchoChar (widgetID : int, echoChar : char)
|
| Description | The GUI.SetEchoChar procedure is used with text fields,
especially when using a text field to input a password.
When the GUI.SetEchoChar is called with a text field,
any character entered into the text field will appear as the
character specified by inputChar. This allows you to use the text field to enter a password. The characters that the user types will be echoed with the character specified by inputChar (often an asterisk).
|
| Example | This program displays a text field. As the user enters
characters, each character is represented as a '*'. When
the user enters return, the program exits after displaying
the actual text entered into the text field.
import GUI
procedure EchoString (s : string)
put "You entered \"", s, "\""
GUI.Quit
end EchoString
var tf := GUI.CreateTextField (10, 100, 100, "", EchoString)
GUI.SetEchoChar (tf, '*')
loop
exit when GUI.ProcessEvent
end loop
|
| Execute | |
| Details | Note that the echoChar argument to GUI.SetEchoChar
must be a character, not a string. This means the character
should be enclosed in single quote marks ('), not double
quotes (").
|
| Status | Exported qualified. This means that you can only call the function by calling GUI.SetEchoChar, not by calling SetEchoChar.
|