Input into Desktop Element
Command description
Enters text into a desktop application input field.
Command Input Parameters
| input parameters | Input parameter type | Description |
|---|---|---|
| Desktop Element | WinElement or str (captured element UID, not element name, not ms-rpa-id) | Input field to use. Select a captured element or use Get Desktop Element, Get Similar Desktop Elements, or Get Related Desktop Elements |
| Input Content | str | Text to enter |
| Append Input | bool | Whether to append the text instead of replacing existing content |
| Tab Key | bool | Whether to press Tab after entering the text; default: False |
| Enter Key | bool | Whether to press Enter after entering the text; default: False |
| Input Method | enum | Human-like Input, Clipboard Input, Silent Input |
| Click Element Before Input | bool | Whether to click the element before entering text |
| Post-Click Delay | number | Time to wait between clicking the element and entering text, in seconds |
| English Keyboard Layout | bool | Whether to force the US English keyboard layout when input-method switching produces incorrect text |
| Element Wait Duration | number | Maximum time to wait for the element to appear, in seconds. The command reports an error if the element does not appear in time |
| Post-Input Delay | number | Time to wait after entering the text, in seconds |
Command Output Parameters
None
Input method
| Input method | Description |
|---|---|
| Human-like Input | Simulates typing one character at a time. Enable English Keyboard Layout when input-method switching causes incorrect text. The element's window is brought to the front |
| Clipboard Input | Copies and pastes the text. The element's window is brought to the front |
| Silent Input | Uses Windows UI Automation without moving the mouse, clicking the element, or changing the clipboard. It is the fastest method, but some input fields do not support it. Use Human-like Input or Clipboard Input when necessary |
Type definition reference
tip
- This command automatically brings the window to the front and restores it if minimized, so Activate Window is normally unnecessary.
- Capture element reference Capture Desktop Elements