Primary properties

A primary TA property is one that obtains its value directly from a given native property.

In most cases, mappings from native properties to TA properties are one-to-one. That is, a given native property of a control is mapped to a single TA property. For example, the native text properties of all Java control classes are mapped to the value TA properties of their corresponding TA classes. In some cases, it may be a one-to-many mapping, where a given native property is used to provide values to more than a single TA property. In fact, the native text property of a Java label control supplies its value not just to the control's value TA property, but to the caption and name TA properties as well.

TA properties of these types are referred to as primary properties. During a window intake, the controls of an application window are scanned, the correct set of TA properties is determined for each control, and each TA property is loaded with a value. For the simplest TA properties, the value is simply copied from the native property mapped to it.

So, to continue with the just-mentioned example, the following Java application window displays a button with the word Login. That display text comes from the button's native text property. Because the text property is mapped to the value TA property, we can see in the Interface Viewer that, once an intake is performed, value also holds the string Login.

Note: Note that not every native property is mapped to a TA property. In some platforms, controls have far more native properties than are generally required for testing.