SIZE property (System)
Description
Returns the width and height of the primary monitor along with the width and height of its workarea (i.e. the space not occupied by the taskbar).
Property Value
This property is an @fm-delimited array formatted as follows:
<1> Monitor Width (SM_CXSCREEN)
<2> Monitor Height (SM_CYSCREEN)
<3> Monitor Workarea Width (SM_CXFULLSCREEN)
<4> Monitor Workarea Height (SM_CYFULLSCREEN)
All dimensions are returned in actual pixels.
Property Traits
Development | Runtime | Indexed | Scaled | Synthetic |
---|---|---|---|---|
N/A | Get | No | Yes | No |
Remarks
This property is implemented for backwards compatibility only. New applications should use the SYSTEM MONITORLIST and WINDOW MONITOR properties to ensure that they work smoothly with multi-monitor scenarios.
The method uses the Windows GetSystemMetrics function to obtain the details for this property, so please refer to the documentation on the Microsoft website for further information on this. The “SM_” flags used with the function are as noted above.
Example
SystemSize = Get_Property( "SYSTEM", "SIZE" ) ; // DIPs - Use @Window SystemSize = Get_Property( "SYSTEM", "SIZE", winID ) ; // DIPs - Use winID SystemSize = Get_Property( "SYSTEM", "SIZE", "*" ) ; // Pixels
See Also
SYSTEM MONITORLIST property, SYSTEM METRICS property, WINDOW MONITOR property.