MONITORLIST property (System)
Description
Returns an array of monitor information for all monitors attached to the system. If a control or window is passed as the property index value all coordinates returned are scaled to DIPs with respect to that control or window.
Property Value
A dynamic array containing monitor information. Multiple monitors are delimited by @fm. Each monitor has the following @vm-delimited structure:
<0,1> Monitor Handle (HMONITOR)
<0,2> Display Rectangle (@svm delimited)
<0,2,1> Display Left
<0,2,2> Display Top
<0,2,3> Display Right
<0,0,4> Display Bottom
<0,3> Work-area Rectangle (@svm delimited)
<0,2,1> Work-area Left
<0,2,2> Work-area Top
<0,2,3> Work-area Right
<0,0,4> Work-area Bottom
<0,4> Flags
<0,5> Device name
The Display Rectangle contains the coordinates of the entire monitor surface. The Work-area rectangle contains the coordinates of the entire monitor surface minus the TaskBar and any docked “AppBars”.
Property Traits
Development | Runtime | Indexed | Scaled | Synthetic |
---|---|---|---|---|
N/A | Get | Yes | Yes | No |
Remarks
This property uses the EnumDisplayMonitors Windows API function internally, so please refer to the documentation on the Microsoft website for further information on monitor enumeration.
Constants for use with this property can be found in the MSWin_Monitor_Equates and PS_Monitor_Equates insert records.
Example
// Get the monitor list in actual pixels MonitorList = Get_Property( "SYSTEM", "MONITORLIST" ) // Get the monitor list win DPIs with respect to the current window MonitorList = Get_Property( "SYSTEM", "MONITORLIST", @Window )
See Also
WINDOW MONITOR property, SYSTEM SIZE property, Common DPI property, Common SCREENSIZE property