check control property

Automation Guide

Action-based testing language

Built-in actions

User Interface actions

Control, Element

check control property

Description

Capture the value of a specified property from a control, then compare it against an expected value. Result is Passed ifthe values match; otherwise Failed.

Arguments

window
TA name of the window.
control
TA name of the control.
property
TA or native property. (e.g., caption, winclass, top, etc.)
expected
Expected value of the property.

Valid contexts

This action may be used within the following project items: test modules and user-defined actions.

Notes

This action is applicable to both TA properties and native properties that are viewable in the Interface Viewer.
In the event that a TA property and native property have identical names, the TA property takes precedence. Therefore, if you want to explicitly check the native property, use the check native property action.
This action is applicable only to properties that are viewable in TestArchitect’s Interface Viewer.
The expected argument can accept regular expressions. Note that argument values that include regular expressions must be entirely enclosed in curly braces {}. As an example, {[A-Z0-9._%+-]+@[A-Z0-9.-]+\.[A-Z]{2,4}} specifies the pattern for an acceptable email address. More simply, .* represents the general wildcard for regular expressions, so that {.*arch.*} matches starch, marching, testarchitect, etc.
This action supports the <ignore> modifier. If the string <ignore> is present as the value of any of the arguments, or any argument contains an expression that evaluates to <ignore>, the action is skipped during execution.

Applicable Built-In Settings

The following settings are applicable to this action: case sensitive, remove double quotes from cells, standard ASCII only, property wait, page wait, object wait, value changed wait, window wait, load invisible controls.

This action is applicable to the following controls: activity indicator view, button, check box, checklist, clock, collection view, collection view cell, combo box, date picker, datetime, frame, image, label, list box, list view, map view, menu, navigation bar, page control, password, picker view, picture box, progress bar, radio button, rating bar, richtext, scroll bar, scroll view, search bar, segmented control, separator, slider, spin, status bar, stepper, switch, tab bar, tab control, table, table view, table view cell, text box, text view, toggle button, toolbar, trackbar, tree view, view, web view, window, calendar.