ValuesSelected Property

Applies to TestComplete 15.47, last modified on January 20, 2023

Description

Use the ValuesSelected property to set whether the specified data cell will be used in comparison of database values with values stored in the DBTable project element that corresponds to the DBTableObj object.

Note: The DBTable object provides access to a copy of the stored data. So, changes made to the ValuesSelected property only effect it during the test execution. The changes will not be applied to data stored in the DBTable project element and will not be displayed in the editor.

Declaration

DBTableObj.ValuesSelected(aRow, aColumn)

Read-Write Property Boolean
DBTableObj An expression, variable or parameter that specifies a reference to a DBTable object
aRow [in]    Required    Integer    
aColumn [in]    Required    Integer    

Applies To

The property is applied to the following object:

Parameters

The property has the following parameters:

aRow

The row index of the desired value. This index coincides with the row position in the DBTable Element editor. The index is zero-based, that is, TestComplete considers that the first row has the index of 0, the second row has the index of 1 and so on. The total number of stored rows is specified by the RowCount property of the DBTable object.

aColumn

The column index of the desired value. This index coincides with the column position in the DBTable Element editor. The index is zero-based, that is, TestComplete considers that the first column has an index of 0, the second column has an index of 1 and so on.

To obtain the index of a column by the column name, use the ColumnIndex property of the DBTable object.

Property Value

True, if the value will be used in comparison and False otherwise.

Remarks

If you use Python or DelphiScript, you should enclose the parameters of the ValuesSelected property in square brackets: ValuesSelected[aRow, aColumn].

Example

To view an example that demonstrates how to use the ValuesSelected property, see the Modifying Data From Scripts section of the Modifying DBTable Elements help topic.

See Also

About Database Checkpoints
Modifying DBTable Elements
ColumnIndex Property
RowCount Property
Values Property

Highlight search results