Display Action Icon

Display  

Declaration

<AMDISPLAY WIDTH="number" HEIGHT="number" COLORS="number" FREQUENCY="number" />

See Also

Change Printer | Empty Recycle Bin | End Process | Get Process Information | Get Volume Information | Log Event | Print | Registry | Run | Set Date and Time

Description

Changes the current resolution and/or color depth settings on the specified display device (video card).

Practical Usage

Example 1: Change the resolution back to a standard setting so that mouse click pixel coordinates would match system conditions and the time a task was created.

Example 2: Create a task that quickly switches the resolution at the press of a hot-key or other trigger.

Parameters

General Properties

Property

Type

Req'd

Default

Markup

Description

Display Device

Text

No

(Primary)

 

DISPLAY="NVIDIA GeForce 9800 GT"

The display device that should be acted on. This parameter is required and especially useful for multi-monitor systems. In visual mode, for convenience, a drop-down is displayed showing the available display devices that are installed on your system. If left blank, the primary display device is acted on.

Color Depth

Number

No

(System Default)

COLORS="32"

The color depth (in bits) to change to. If left blank, the color depth remains the same. In visual mode, for convenience, a drop-down is displayed showing the available color depth settings for the currently specified display device.

Display Frequency

Number

No

(System Default)

FREQ="70"

The frequency (in Hz) to change to. If left blank, the frequency remains the same. In visual mode, for convenience, a drop-down is displayed showing the available frequency settings for the currently specified display device.

Width

Number

No

(System Default)

WIDTH="1680"

The width (in pixels) that the resolution should be modified to. If left blank, the width remains the same. In visual mode, for convenience, a drop-down is displayed showing the available width settings for the currently specified display device. A supported corresponding Height parameter must also be selected for proper functioning. In visual mode use the slider control and the Test chosen display settings  button to determine proper values for both parameters.

Height

Number

No

(System Default)

HEIGHT="1050"

The height (in pixels) that the resolution should be modified to. If left blank, the height remains the same. In visual mode, for convenience, a drop-down is displayed showing the available height settings for the currently specified display device. A supported corresponding Width parameter must also be selected for proper functioning. In visual mode use the slider control and the Test chosen display settings  button to determine proper values for both parameters.

Description Properties

The Description tab allows you to customize the text description of any step as it appears in the Task Builder's Steps Pane.

More on setting custom step description

Error Causes Properties

The Error Causes tab allows you to select/omit specific errors that should cause a particular step to fail.

More on Error Causes properties

On Error Properties

The On Error tab allows you to determine what the task should do if a particular step encounters an error.

More about On Error properties

Additional Notes

Provided Resolution Selection Slider

The "Less/More" slider is available in visual mode to assist in selecting width height combinations that are supported by the display device specified in the "Display Device" parameter. Use of this slider control is recommended in selecting resolutions.

Provided "Test" button

The Test button allows a given resolution/frequency/color-depth setting to be tested before being added to a task. It also provides the user with an automatic switchback mechanism if the user does not respond within 15 seconds in case the display is unreadable using the settings. Use of the test button before using this action in a task is recommended.

Variables and Expressions

All text fields allow the use of expressions, which can be entered by surrounding the expression in percentage signs (example: %MYVARIABLE%, %Left('Text',2)%). To help construct these expressions, you can open Expression Builder from these fields by pressing F2.

More on variables
More on expressions

More on the expression builder

Example

NOTE: The code below can be copied and pasted directly into the Steps pane of the Task Builder.

 

Description: Set 1680 x 1050 x 32 bit x 59 Hz mode on VMware SVGA 3D (Microsoft Corporation - WDDM).  

 

<AMDISPLAY WIDTH="1680" HEIGHT="1050" COLORS="32" FREQUENCY="59" />

 

↑ Top of Page