check native property


Check the value of a native property of a control against an expected value. Result is Passed if the values match; otherwise Failed.


TA name of the window.
TA name of the control.
Native property of the control.
Expected value of the property.

Valid contexts

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

Applicable Systems/Platforms

This built-in action is supported on the following systems/platforms:
Desktop applications
  • Windows:
    • WPF
    • Silverlight
  • macOS:
    • Safari
Mobile applications
  • Android
    • Chrome
  • iOS:
    • Native applications
    • Safari


  • Although TestArchitect provides access to native properties, you should use it very carefully. Because accessing native properties can perform critical or unsafe operations in the AUT that may change the AUT's current state.
  • property argument: You can find native properties in the Native Properties tab of the 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._%+-][email protected][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, page wait, object wait, value changed wait, window wait, load invisible controls, color format.

Applicable Controls

This action is applicable to the following controls: button, check box, checklist, clock, combo box, datetime, frame, label, list box, list view, menu, password, picture box, progress bar, radio button, rating bar, richtext, scroll bar, separator, spin, status bar, tab control, table, text box, toggle button, toolbar, trackbar, tree view, window and calendar.


Action Lines