Skip to content
Release: Australia · Updated: 2026-03-12 · Official documentation · View source

Use the Find Window component

Set the focus back on various windows that are inactive or running in the background as part of a Robotic Process Automation workflow in the RPA Desktop Design Studio.

Before you begin

Role required: none

About this task

The Find Window component identifies one or more rules associated with a Window and later uses the rules to set the focus back on the window. The component also returns the window handle of the window.

You can configure the properties for the Find Window component. For more information about these properties, see Properties of the General components.

Procedure

  1. In the Toolbox pane, navigate to General > Find Window.

  2. Drag the Find Window component to the Design surface.

  3. Click the component settings icon (

Image omitted: component-settings-icon.png
Component settings icon\).
  1. Click and drag the capture window icon (
Image omitted: drag-window.png
Capture window icon.\) and drop it on the window that you want to find.
The POTENTIAL MATCH RULES window shows the rules matching the window.
Image omitted: find-window.png
Rules matching a window
  1. Select a rule by clicking the rule.

    Tip: To select more than one rule, press Shift and click the rules.

  2. In the POTENTIAL MATCH RULES window, click OK.

    The FIND WINDOW MATCH RULES window displays the rules matching the captured windows.

  3. In the FIND WINDOW MATCH RULES window, click OK.

  4. Connect the data and control ports of the Find Window component to the corresponding ports of the other components.

    Port typePort nameData typePurpose of connectionMandatory?
    Data inSet FocusBooleanIf True, the focus is set on the window else, the window continues to run in the background.Yes
    Control outFailNot applicableIf the component fails to execute, passes the control to the next component.No
    Data outWindow HandleIntegerReturns the window handle.Not applicable.
  5. To test the component, under the DESIGN tab, click Run.

Parent Topic:General