wPosition Property (ScrollBar Controls)

Applies to TestComplete 15.47, last modified on January 20, 2023
This property is not supported in web tests (including cross-platform web tests) that use XPath expressions and CSS selectors to locate web elements. This property can be only used in tests that locate web objects by using internal identification properties provided by TestComplete.

Description

Use the wPosition property to get or set the current logical position of the control’s slider. This value must be within the range wMin...wMax (bounds are included).

Declaration

TestObj.wPosition

Read-Write Property Integer
TestObj A variable, parameter or expression that specifies a reference to one of the objects listed in the Applies To section

Applies To

The property is applied to the following objects:

View Mode

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

Property Value

An integer value specifying the current position of the slider.

Remarks

  • Syncfusion ScrollBar, Qt ScrollBar:

    If you assign a value to wPosition and this value is greater than wMax (or less than wMin), it will be automatically replaced with wMax (or wMin).

  • Developer Express ScrollBar, Telerik RadScrollBar for WinForms:

    If you try to set the value of wPosition that is less than wMin or greater than wMax, the slider position will be set equal to the wMin or the wMax value and an error message will be posted to the test log.

Example

To view an example that demonstrates how to use the wPosition property, see Getting the Scroll Box's Position in Desktop Windows Applications.

See Also

Getting the Scroll Box's Position in Desktop Windows Applications
wMax Property (ScrollBar Controls)
wMin Property (ScrollBar Controls)

Highlight search results