Entering Passwords into an Edit Control

Applies to TestComplete 14.0, last modified on January 23, 2019

While testing edit controls, you can use specific properties and methods of the corresponding program object to perform certain actions and obtain data stored in controls. You can call these methods and properties from your keyword tests, as well as from scripts. This topic describes how to work with the needed properties and methods from your scripts. However, when testing a control from your keyword test, you can use the same methods and properties calling them from keyword test operations. For more information, see Keyword Tests Basic Operations.

If the current edit control is a password dialog box, it displays placeholder characters instead of symbols typed by the user. Symbols that are displayed instead of the user's input are specified by the application. The standard symbol that replaces the characters is an asterisk (*). You can use the wPasswordChar property to find out which symbol is used to replace password characters. Here is an example:

JavaScript, JScript

// Post a password character to the log
Log.Message (Edit.wPasswordChar);

Python

# Post a password character to the log 
Log.Message (Edit.wPasswordChar)

VBScript

' Post a password character to the log
Log.Message Edit.wPasswordChar

DelphiScript

// Post a password character to the log
Log.Message(Edit.wPasswordChar);

C++Script, C#Script

// Post a password character to the log
Log["Message"](Edit["wPasswordChar"]);

Note: This property is used with single-line edit controls only.

TestComplete provides a special Password variable type. The values specified for variables of this type are encrypted. You can use variables of this type to enter data in the edit control by using the SetText or Keys action. The value you enter is not posted to the log, and the image in the log does not contain the entered text.

JavaScript, JScript

// Enter the password
Sys.Keys(Project.Variables.Var1);

Python

# Enter the password
Sys.Keys(Project.Variables.Var1)

VBScript

' Enter the password
Sys.Keys(Project.Variables.Var1)

DelphiScript

// Enter the password
Sys.Keys(Project.Variables.Var1);

C++Script, C#Script

// Enter the password
Sys["Keys"](Project["Variables"]["Var1"])

A password is entered in the same way text is entered in an edit control (for detailed information, see Entering Text into an Edit Control). The following example demonstrates how you can enter a password in an edit control:

JavaScript, JScript

// Enter the password
Sys.Keys("MyPassword");

Python

# Enter the password
Sys.Keys("MyPassword")

VBScript

' Enter the password
Sys.Keys "MyPassword"

DelphiScript

// Enter the password
Sys.Keys('MyPassword');

C++Script, C#Script

// Enter the password
Sys["Keys"]("MyPassword");

The length of the password can be limited (see Determining Maximum Text Length in an Edit Control). If the length is limited, you can enter, for example, only 5 symbols and further input is impossible.

Note: If you use an edit control in password mode, you may not want to store the password in a test. You can use the BuiltIn.InputBox routine or create a custom user form (for detailed information, see Entering Passwords) to avoid security problems.

See Also

Working With Edit Controls
Entering Passwords
wPasswordChar Property (Edit Controls)
Determining Maximum Text Length in an Edit Control

Highlight search results