Set Resolution

The Set Resolution action sets the screen resolution of the screen or screens selected by the user to the desired resolution. This action is helpful when you are working with an application and the targeting tool is missing the target. It is also useful when you are using Remote Desktop Protocol (RDP). You can also use the Maximize Window action to maximize the target window.

Note: The Actions Quick Reference provides a complete list of actions that you can print for easy reference.

Create a Set Resolution action

  1. On the Actions list, click Computerand select Set Resolution.

    If you are creating a new action, the Preferences open. If you are modifying an existing action, the settings from the original action are displayed.

  2. Select to set the resolution for All monitors, the Active monitor, or an Exact monitor. If you select to set the resolution for an Exact monitor, enter the number of the monitor to set. Optionally, click the Magic Wand to use the Expression Builder.

    Note: 
    • If you select All monitors, Nintex Bot detects all of the monitors connected at the time and displays them for you to select. It will automatically detect the current active monitor’s resolution and display it.

    • If a match cannot be found between the resolution available to select in Nintex Bot or the value selected in Preferences and the available resolutions detected on the machine, the mode will be changed to Exact.

    • If you select Exact monitor, then you must ensure that the monitor exists. Nintex Bot does not validate the existence of the monitor.

  3. Select the Resolution from the drop-down list. If you select Exact, enter the exact Width and Height resolution. Optionally, click the Magic Wand to use the Expression Builder.

  4. If needed, adjust the Run error task settings to fine tune how the action runs.

    • Run error task: A botflow containing an error task automatically runs the error task in the event of an error. If the botflow does not contain an error task, the botflow stops in the event of an error.
    • Stop on error: The botflow stops in the event of an error.
    • Ignore errors: The action is skipped in the event of an error and the botflow attempts to execute the next action.
  5. (Optional) Add a Note to document special instructions or functionality.

  6. Toggle the run switch to Run and click OK to execute and save the action.

  7. Note: The run switch is set to Run by default. To create or modify this action without executing it, click the slider to change the option to Don't Run.  For more information, go to Action Builder.

If you selected to set the resolution for All monitors, when the action executes it will first check for the mode to be set to all monitors and if it is, a call is made at runtime to collect all the available monitors on the current machine so that they can be modified. Next, Nintex Bot will attempt to set the resolution of each monitor, using the device name extracted in the call above, to the desired width and height. After the attempt to change the resolution to each screen, a second call to get the display device settings is made to check if the resolution has successfully been changed or not. If it has been changed, the action returns success; if not, the action will stop attempting to change the resolution of any more monitors, but will not roll back any that may have been changed. If all monitors are updated, the action returns success.

If you selected to set the resolution for the Active monitor, the action will obtain the active screen from the system by getting whichever screen that the Nintex Bot is running on. Next, it will attempt to modify the resolution of the screen Nintex Bot is running on. A check is made after the attempt to change it and then success or failure is returned.

If you selected to set the resolution for the Exact monitor, when the action executes a call is made at runtime to collect all the available monitors on the current machine. Next, the monitor number is extracted from the device name and that is compared to the value in the action. Next, Nintex Bot will attempt to set the resolution of that monitor to the desired width, using the device name that the device number was extracted from.