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.

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

Clicks the out of TextBox, slightly to the left, to take away the focus of the box.

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.

Counts the amount of pw characters in the text box and returns a string with * characters of this length.

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.

Last updated