isPasswordMask is used to make the input or displayed values invisible.
in Lycia Form Designer |
Form XML code:
<element_name isPasswordMask="true">
By default, the property is set to none and is absent from the form XML code. The property value will appear in the form XML code only once the property value is set.
Possible values: true, false
Default value: false
Associated containers, widgets and theme elements:
Associated 4gl syntax:
Associated ui methods:
SetIsPasswordMask ↓
GetIsPasswordMask
Influence and behavior:
If isPasswordMask is set to true, the input text will be hidden (replaced by ):
lycia form designer |
For the first text field (identifier=f1), isPasswordMask=false:
|
For the second text field (identifier=f2), isPasswordMask=false:
|
4gl code |
MAIN DEFINE f1, f2 STRING
OPEN WINDOW w WITH FORM "isPasswordMask" ATTRIBUTE(BORDER)
MENU COMMAND "input" INPUT BY NAME f1 WITHOUT DEFAULTS INPUT BY NAME f2 WITHOUT DEFAULTS COMMAND "display" DISPLAY "isPasswordMask = false" TO f1 DISPLAY "isPasswordMask = false" TO f2 COMMAND "exit" EXIT MENU END MENU
END MAIN
|
|
input value |
isPasswordMask = false |
isPasswordMask = true |
runtime behavior for INPUT |
||
runtime behavior for DISPLAY |
At runtime, you can use ui methods to find out and change the property value (so as to make the input text visible or masked):
LET widget_var = ui.<widget>.ForName("widget_id1")
CALL widget_var.setIsPasswordMask(...)
4gl code sample |
DEFINE tf_1 ui.TextField ... LET tf_1 = ui.TextField.ForName("f1") ... COMMAND "change & input" CALL tf_1.setIsPasswordMask(0) ... COMMAND "change & display" CALL tf_1.setIsPasswordMask(1)
|
DEFINE tf_2 ui.TextField ... LET tf_2 = ui.TextField.ForName("f2") ... COMMAND "change & input" CALL tf_2.setIsPasswordMask(1) ... COMMAND "change & display" CALL tf_2.setIsPasswordMask(0)
|
input value |
input text |
input text |
runtime behavior for INPUT |
||
runtime behavior for DISPLAY |
The example above were taken from the example program.
Example programs:
CVS server: client.querix.com
CVS repository: /lycia_doc_examples
User: client
Project: form_properties
Program: isPasswordMask
Related articles: