ssGlobals.ssMonitorInfo

A string in XML format that contains a collection of nodes that contain the size of the display area and work area of each monitor.


Availability:

First available in version 3.0 build 2039.


Notes:

This is a sample of what you will see in ssGlobals.ssMonitorInfo for a single monitor system running at 1280x1024 with the taskbar at the bottom of the desktop.

<monitors>
    <monitor handle="65537">
        <displayarea left="0" top="0" bottom="1024" right="1280" primary="true" />
        <workarea left="0" top="0" bottom="996" right="1280" />
    </monitor>
</monitors>

The workarea of the system is slightly smaller than the full display area because it does not include the area covered by the taskbar.

ssGlobals.ssMonitorInfo provides the coordinates of the work area so you can easily determine where the taskbar is located on the desktop. In this case it is located at 0,996 and is 1280 pixels wide and 28 pixels high.

The actual coordinates of the taskbar are left=-2, top=996, bottom=1026 and right=1282 making the taskbar window 1284 pixels wide and 30 pixels high. This places part of the taskbar window off the visible display so it appears to be 1280x28.

This variable is automatically updated whenever there is a change to the desktop settings.