SystemInfo.WinSystemMetrics
---------------------------

Retrieves the specified system metric or system configuration setting.

| Component | Version | macOS | Windows | Linux | Server | iOS SDK |
|---|---|---|---|---|---|---|
| [SystemInfo](component_SystemInfo.md) | [6.3](newinversion63.md) | ❌ No | ✅ Yes | ❌ No | ✅ Yes, on Windows | ❌ No |

MBS( "SystemInfo.WinSystemMetrics"; ID ) 

**MBS**( **"SystemInfo.WinSystemMetrics";** /\* Retrieves the specified system metric or system configuration setting. \*/  
**$ID**) /\* The ID of the value to query.  
Can be the name of the value without SM\_ prefix like "CMONITORS" or the numeric value like 80.e.g. "CMONITORS" \*/ 

### Parameters

| Parameter | Description | Example |
|---|---|---|
| ID | The ID of the value to query.   Can be the name of the value without SM\_ prefix like "CMONITORS" or the numeric value like 80. | "CMONITORS" |

### Result

Returns value or error.

### Description

Retrieves the specified system metric or system configuration setting.  
Note that all dimensions retrieved by GetSystemMetrics are in pixels.  
  
Please see Microsoft website for all the possible parameters and return values:  
<https://msdn.microsoft.com/en-us/library/windows/desktop/ms724385(v=vs.85).aspx>  
  
Values for Digitizer query:  
  
| Name | Value | Meaning |
|---|---|---|
| NID\_INTEGRATED\_TOUCH | 1 | The device has an integrated touch digitizer. |
| NID\_EXTERNAL\_TOUCH | 2 | The device has an external touch digitizer. |
| NID\_INTEGRATED\_PEN | 4 | The device has an integrated pen digitizer. |
| NID\_EXTERNAL\_PEN | 8 | The device has an external pen digitizer. |
| NID\_MULTI\_INPUT | 64 | The device supports multiple sources of digitizer input. |
| NID\_READY | 128 | The device is ready to receive digitizer input. |

### Examples

Query number of display monitors on a desktop.

 MBS ( "SystemInfo.WinSystemMetrics"; "CMONITORS")  
<small>  
Example result: 1</small>Query size of screen:

 MBS ( "SystemInfo.WinSystemMetrics"; "CXScreen")   
&amp; " x " &amp;   
MBS ( "SystemInfo.WinSystemMetrics"; "CYScreen")  
<small>  
Example result: 1280 x 768</small>Query whether we are shutton down:

 MBS ( "SystemInfo.WinSystemMetrics"; "SHUTTINGDOWN")  
// Returns 1 if FileMaker Window Close Script Trigger was called due to shutdown  
<small>  
Example result: 0</small>Query whether system is a Tablet PC:

 MBS ( "SystemInfo.WinSystemMetrics"; "TabletPC")  
<small>  
Example result: 1</small>Query whether we are in slate mode:

 MBS ( "SystemInfo.WinSystemMetrics"; "ConvertibleSlateMode")  
// Returns 0 for slate mode, else non-zero  
<small>  
Example result: 0</small>Query whether mouse is installed:

 MBS ( "SystemInfo.WinSystemMetrics"; "MousePresent")  
<small>  
Example result: 1</small>Query whether a mouse wheel is present:

 MBS ( "SystemInfo.WinSystemMetrics"; "MouseWheelPresent")  
<small>  
Example result: 1</small>Query whether we have a digitizer

 MBS ( "SystemInfo.WinSystemMetrics"; "Digitizer")  
// Nonzero if the current operating system is Windows 7 or Windows Server 2008 R2 and the Tablet PC Input service is started; otherwise, 0.   
// The return value is a bitmask that specifies the type of digitizer input supported by the device.   
// e.g. 193 for a ready touch device with multi touch.  
<small>  
Example result: 193</small>Query whether we have a remote session:

 MBS ( "SystemInfo.WinSystemMetrics"; 4096 )  
### Blog Entries

- [MBS FileMaker Plugin, version 6.3pr3](https://www.mbsplugins.de/archive/2016-06-19/MBS_FileMaker_Plugin_version_6/monkeybreadsoftware_blog_filemaker)

This function is free to use.

Created 15th June 2016 , last changed 5th September 2025

  
[SystemInfo.WinSuiteMask](SystemInfoWinSuiteMask.md) - [SystemInfo.WindowsAero](SystemInfoWindowsAero.md)

[HTML Version](SystemInfoWinSystemMetrics.shtml)