Populate Text Field
Description
Appends or replaces the specified text inside the selected text field, either plain or secured.
This activity might require an active display and an unlocked user session to successfully simulate interactions with UI components. For more detailed information, please refer to the relevant section in the Desktop Automation Notes.
Properties
Input
- Automation Mode – Defines the method of automating UI elements through hardware drivers or the Send Windows Messages API. The default option is Drivers.
Mode | Description |
---|---|
Drivers | Utilizes hardware drivers to simulate UI components' interactions directly. This approach requires an active display and an unlocked user session. |
Window Messages | Utilizes the Send Windows Messages API for automation, eliminating the need for an active display or unlocked session. Note: This mode is compatible only with certain types of applications that support window message-based automation and may not work with others, such as WPF applications. |
Simulate | Uses the Windows Automation Library to simulate interactions directly with UI components. This method does not require an active display or an unlocked user session. |
-
Delay After – Sets the Delay time in milliseconds with a default value of 100 milliseconds. Waits for the input Delay time after executing this Activity.
-
Delay Before – Sets the Delay time in milliseconds with a default value of 100 milliseconds. Waits for the input Delay time before the Activity begins execution.
-
Secured Text - Specify the confidential or hidden text to insert into the selected field. It accepts a string of type SecureString.
-
Text - Specify the plain text to insert into the selected field.
-
Text Type - The type of text needs to populate in a text field. Select the appropriate type from the dropdown.
Text Type | Description |
---|---|
Plain | Select this option to populate plain text using the value specified in the Text property. |
Secured | Select this option to populate secured text using the value provided in the Secured Text property. |
Text Mode - Specify the operation mode from the dropdown.
Text Mode | Description |
---|---|
Replace | Replaces the Text with the existing text |
Append | Appends the Text to the current text |
-
Window Instance - Specify the window instance identified through Window Selector. You can also type in the window instance for automation.
-
Search Parameters – Holds the information of the UI element identified through Element Selector.
Misc
-
DisplayName – The display name of the Activity.
-
Private – Logs the variable and argument values at the Verbose level when unchecked.
Optional
-
Timeout – Specify the activity's duration so that a response can be waited to complete the requested operation. The activity triggers a timeout error if it does not respond within this timeframe. The default wait time is 30 seconds.
-
Continue On Error – It Specifies whether the automation should continue even when the Activity throws an error. If True, the Activity continues without throwing any exceptions. If False, the Activity throws an exception. The default value is False.
Catches no error if this Activity is present inside the Try-Catch block and the value of this property is True.
Example
Download Example