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:

Object Progile.TRIO.BaseModel.OnScreenElement Progile.TRIO.BaseModel.TextBox Progile.TRIO.BaseModel.PwTextBox

Constructors

Syntax:

public PwTextBox(
	IAppBasics appBasics,
	string displayName,
	ImageReference imageReference,
	ImageReference pwCharImage,
	params IImageFilter[] filters
)

Parameter	Description
appBasics	Type: Progile.TRIO.BaseModel.IAppBasics 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
ClickOutOfBox	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.
VerifyText(String, String)	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.
VerifyText(String)	Verifies if the password was entered correctly by counting the number of characters based on pwCharImage that were entered.