Links

PwTextBox

Description

A text box with blind or hidden entry, as it is typically used for passwords. Every entered character must be represented by the same placeholder character (often a bullet or an asterisk). An image representation of this character needs to be given in the constructor of the PwTextBox. Instead of the standard Enter and Verify methods you should use EnterPassword and VerifyPasswordEntry to interact with the PwTextBox.
Example of a password textbox with 8 hidden password characters.

PwTextBox Class

Namespace: Progile.TRIO.BaseModel Assembly: Progile.TRIO.BaseModel (in Progile.TRIO.BaseModel.dll)

Inheritance Hierarchy:

Constructors

Syntax:
public PwTextBox(
IAppBasics appBasics,
string displayName,
ImageReference imageReference,
ImageReference pwCharImage,
params IImageFilter[] filters
)
Parameter
Description
appBasics
The interface for the AppBasics, that is available on every BaseScreen. Allows access to the testerinterface and the system interactions.
displayName
Type: String The name of the element that will be used for logging and reporting of exceptions (customer facing).
imageReference
Type: ImageReference The image that will be used to locate the TextBox on the screen. The hotspot of the image must be set within the textbox border.
pwCharImage
Type: ImageReference The image that defines the hidden pw character. It will be used to verify the number of characters entered.
filters
Type: IImageFilter[ ] Typically a Select filter indicating the area of interest for the image search.

Methods

Name
Description
Clicks the out of TextBox, slightly to the left, to take away the focus of the box.
Enter
Clicks in the textbox (using hotspot of locationImage), selects all and types the pw. The interaction is verified by counting the number of characters based on pwCharImage that were entered. If the number doesn't match the pw, retries are done as configured.
GetText
Counts the amount of pw characters in the text box and returns a string with * characters of this length.
PasteText
Pastes the text from the internal clipboard to the text box. Overwrites what was in the text box before.
Verifies if the password was entered correctly by counting the number of characters based on pwCharImage that were entered. If not, provides a string with as many * characters as were found in the textbox.
Verifies if the password was entered correctly by counting the number of characters based on pwCharImage that were entered.