wValue Property (Specific to Qt TableWidget Controls)

Applies to TestComplete 15.70, last modified on December 17, 2024

Description

Use the wValue property to obtain or set the value held in the specified table widget cell.

Declaration

TestObj.wValue(Row, Column)

Read-Write Property Variant
TestObj A variable, parameter or expression that specifies a reference to one of the objects listed in the Applies To section
Row [in]    Required    Variant    
Column [in]    Required    Variant    

Applies To

The property is applied to the following object:

View Mode

This property is available in the Object Browser panel and in other panels and dialogs in both Basic and Advanced view modes.

Parameters

The property has the following parameters:

Row

Specifies the table widget row that contains the desired cell. You can specify the desired row by its index or header.

The index is zero-based and corresponds to the column’s position within the object's internal columns collection rather than the column’s visible position in the object.

The caption can contain asterisk (*) or question mark (?) wildcards or regular expressions. The asterisk corresponds to a string of any length, the question mark corresponds to any single character. To specify more complicated parts of a caption, use regular expressions.

The caption can be case-sensitive or case-insensitive depending on the value of the Use case-sensitive parameters project setting.

Column

Specifies the table widget column that contains the desired cell. You can specify the desired column by its index or header.

The index is zero-based and corresponds to the column’s position within the object's internal columns collection rather than the column’s visible position in the object.

The caption can contain asterisk (*) or question mark (?) wildcards or regular expressions. The asterisk corresponds to a string of any length, the question mark corresponds to any single character. To specify more complicated parts of a caption, use regular expressions.

The caption can be case-sensitive or case-insensitive depending on the value of the Use case-sensitive parameters project setting.

Property Value

A variant that represents the cell’s contents. If the specified cell is not found, wValue returns the null value (Nothing in VBScript, nil in DelphiScript, None in Python, null in JavaScript, JScript, C++Script and C#Script) and posts an error message to the test log.

Remarks

You can use wValue property along with wRowCount and wColumnCount property to iterate through the table's widget cells.

See Also

wColumn Property (Grid Controls)

Highlight search results