Table of Contents

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

DevelopmentRuntimeIndexedScaledSynthetic
N/AGetNoYesNo

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.