Lingo Dictionary > D-F > deskTopRectList |  |

deskTopRectList

Syntax

    the deskTopRectList

Description

System property; displays the size and position on the desktop of the monitors connected to a computer. This property is useful for checking whether objects such as windows, sprites, and pop-up windows appear entirely on one screen.

The result is a list of rectangles, where each rectangle is the boundary of a monitor. The coordinates for each monitor are relative to the upper left corner of monitor 1, which has the value (0,0). The first set of rectangle coordinates is the size of the first monitor. If a second monitor is present, a second set of coordinates shows where the corners of the second monitor are relative to the first monitor.

This property can be tested but not set.

Example

This statement tests the size of the monitors connected to the computer and displays the result in the Message window:

    put the deskTopRectList
    -- [rect(0,0,1024,768), rect(1025, 0, 1665, 480]

The result shows that the first monitor is 1024 by 768 pixels and the second monitor is 640 by 480 pixels.

Example

This handler tells how many monitors are in the current system:

    on countMonitors
    	return the deskTopRectList.count
    end