guides:programming:programmers_reference_manual:monitorlist_property_system

MONITORLIST property (System)

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.

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”.

DevelopmentRuntimeIndexedScaledSynthetic
N/AGetYesYesNo

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.

 
// 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 )
 
 
 

WINDOW MONITOR property, SYSTEM SIZE property, Common DPI property, Common SCREENSIZE property

  • guides/programming/programmers_reference_manual/monitorlist_property_system.txt
  • Last modified: 2023/10/25 10:50
  • by 127.0.0.1