Scroll

The Scroll Activity enables you to scroll content within a selected desktop application or UI element. You can configure the scroll direction, scroll amount, execution method, delays, and wait time to control how the scrolling operation is performed.

Note: The Scroll Activity supports vertical and horizontal scrolling, depending on the capabilities of the selected application or UI element.

Application Focus

The application does not need to be in the foreground when the target element supports the UI Automation ScrollPattern.

If the activity uses simulated mouse-wheel input as a fallback, the application must be visible, unobstructed, and running in an unlocked interactive session. The activity does not automatically bring the application to the foreground.

Prerequisites

1. Ensure the target desktop application is open and accessible.
2. Select the required UI element using Edit Element before executing the activity.
3. Ensure that the selected element supports scrolling in the required direction.
4. Select the actual scrollable container rather than a parent window or non-scrollable container.

Properties

INPUT

DelayAfter: Specifies the time to wait after the scroll operation is completed. The value is specified in milliseconds. The default value is 300.

DelayBefore: Specifies the time to wait before performing the scroll operation. The value is specified in milliseconds. The default value is 200.

Direction: Specifies the direction in which the content is scrolled. The available options are:

Top: Scrolls to the beginning of the scrollable content.
Bottom: Scrolls to the end of the scrollable content.
VerticalUp: Scrolls vertically upward.
VerticalDown: Scrolls vertically downward.
HorizontalLeft: Scrolls horizontally to the left.
HorizontalRight: Scrolls horizontally to the right.

ExecutedBy: Specifies the interaction method used to perform the scroll operation.

ScrollAmount: Specifies the number of scroll units or notches used during the scrolling operation. Higher values generally result in a greater scrolling distance.

Examples:
1: Performs one scroll unit in the selected direction.
3: Performs three scroll units.
10: Performs ten scroll units, resulting in a greater scrolling distance.

Note: The actual scrolling distance may vary depending on the target application, control implementation, execution method, and operating system settings.

WaitTime: Specifies the maximum time allowed for the target element to be identified and the scroll operation to be performed. The value is specified in milliseconds. The default value is 10000.

MISC

DisplayName: Specifies the display name of the activity. You can customize this value to make the activity easier to identify in the workflow.

SkipOnError: Specifies whether workflow execution continues when an error occurs.
True: Logs the error and continues workflow execution.
False: Throws an exception and stops workflow execution.
None: Behaves as False by default.

Version: Displays the current version of the activity.

OUTPUT

Result: Returns the success state of the scroll operation.
True: The scroll operation completed successfully.
False: The scroll operation did not complete successfully.

Supported Controls

The Scroll activity supports scrollable UI elements, including:

a. Lists and tables
b. DataGrids
c. Tree views
d. Documents and document viewers
e. Scrollable panels and panes
f. Other scrollable containers

Scrolling behavior depends on the UI Automation capabilities of the selected element and the scrolling method used.

DataGrid Support: For UI Automation-based scrolling, the selected DataGrid or its scrollable container must support the ScrollPattern and the configured scrolling direction.

Note: Browser windows may not expose the ScrollPattern directly. When automating browser-based applications, select the specific scrollable element within the page instead of the browser window.

Scrolling Behavior and Limitations

The Scroll activity scrolls the selected UI element in the configured direction. If the element does not support the required scrolling operation, the activity may fail with an error.

Some controls, such as virtualized DataGrids, expose only the rows that are currently visible through UI Automation. Scrolling to the end of the control does not guarantee that all records in the underlying dataset are available to downstream data extraction activities.

Important: The amount of data available depends on how the target application exposes its content through UI Automation. The Scroll activity navigates within the selected element but does not control how the application loads or exposes its data.