isPasswordMask

 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:

Browser

FunctionField

TextField

TimeEditField

 

Associated 4gl syntax:

DISPLAY

INPUT

 

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:

invisibleValue