Activate Window
Command description
Brings a specified window to the front and restores it if minimized. The window can be identified by object, title, handle, or an element it contains. Desktop element click, input, and capture commands already activate the target window, so this command is normally unnecessary before them.
Command Input Parameters
| input parameters | Input parameter type | Description |
|---|---|---|
| Retrieval Method | enum | Window Object, Title, Window Containing Element, Window Handle |
| Window | WindowInstance | Window to activate. Required when Retrieval Method is Window Object |
| Title | str | Text contained in the target window's title. Required when Retrieval Method is Title |
| Element | WinElement or str (captured element UID, not element name, not ms-rpa-id) | Element contained in the target window. Required when Retrieval Method is Window Containing Element. Select a captured element or use Get Desktop Element, Get Similar Desktop Elements, or Get Related Desktop Elements |
| Window Handle | int or str | Handle of the target window. Required when Retrieval Method is Window Handle |
Command Output Parameters
None
Type definition reference
tip
- Capture element reference Capture Desktop Elements