About:

Wrapped collection of Monitor objects.

Download:

Version 1.0

Dependencies:

Monitor class

Multi monitor helper module

Rectangle class

Properties:

Count

Access:
Get

Description:
Returns the number of monitor objects stored in the internal class

Item

Access:
Get

Description:
Returns the requested Monitor object from the internal collection

Area

Access:
Get

Description:
Returns a Rectangle object specifying the bounds of the virtual screen area

Methods:

ReQuery()

Description:
Requests the object to re-query the monitor devices attached to the system

FromPoint()

Description:
Returns the monitor at the given point

Parameters:

Name	Description
inX	Horizontal coordinate
inY	Vertical coordinate
[inFlags]	A enMonitorFlagsDefaultTo value specifying what action to take if there is no monitor at the given coordinates

Return:
A Monitor object containing information about the monitor at the given coordinates

FromWindow()

Description:
Returns the monitor the specified window is located within
Note: if the window spans more than one monitor then the monitor that contains the largest percentage of the window's area is returned

Parameters:

Name	Description
inWnd	Window handle to find
[inFlags]	A enMonitorFlagsDefaultTo value specifying what action to take if there is no monitor at the given coordinates

Return:
A Monitor object containing information about the monitor which the given window is located on

FromRect()

Description:
Returns the monitor the specified rectangle is located within
Note: if the rectangle spans more than one monitor then the monitor that contains the largest percentage of the rectangle's area is returned

Parameters:

Name	Description
inRect	A Rectangle object specifying the coordinates of the area to search for
[inFlags]	A enMonitorFlagsDefaultTo value specifying what action to take if there is no monitor at the even coordinates

Return:
A Monitor object containing information about the monitor which the given rectangle is located on

PrimaryMonitor()

Description:
Retrieve information about the primary monitor

Return:
A Monitor object containing information about the primary monitor

NewEnum()

Description:
Private function used to provide For ... Each access to the monitors object's Monitor's

Return:
Returns the internal collection's enumerator object

OnDisplayChange()

Description:
Friend method called when the notification window receives a display change notification.

CleanUp()

Description:
Clears the object's internal properties

NewPoint()

Description:
API Point structure constructor function

Parameters:

Name	Description
inX	Horizontal coordinate
inY	Vertical coordinate

Return:
A PointL structure containing the desired coordinates

RectToUDT()

Description:
Routine to convert a Rectangle object to a RectAPI structure

Parameters:

Name	Description
inRect	The Rectangle object to convert

Return:
A RectAPI structure containing the coordinates of the given Rectangle object

Class_Initialize()

Description:
Initialize event handler of the object

Class_Terminate()

Description:
Terminate event handler of the object

User defined types:

RectAPI

Description:
Rectangle API structure
RECT structure on the MSDN.

PointL

Description:
2D point API structure
POINT structure on the MSDN.

Enumerators:

enMonitorFlagsDefaultTo

Description:
Specifies the action taken if the given area does not fall within any of the system's monitors

Variables:

Name	Description
mfdtNull	Returns Nothing
mfdtPrimary	Returns the primary monitor
mfdtNearest	Returns the nearest monitor

Events:

Changed

Description:
Raised after the display settings have been refreshed

DisplayChanged

Description:
Raised when the system's display settings change

Parameters:

Name	Description
inNoRefresh	If this is set to True then the display devices will not be re-queried.

API:

GetSystemMetrics

MonitorFromPoint

MonitorFromRect

MonitorFromWindow