Topics   All   MacOS (Only)   Windows (Only)   Linux (Only, Not)   iOS (Only, Not)  
Components   Crossplatform Mac & Win   Server   Client   Old   Deprecated   Guides   Examples   Videos
New in version: 10.5   11.0   11.1   11.2   11.3   11.4   11.5   12.0   12.1   12.2    Statistic    FMM    Blog  


Takes a screenshot of the screen indicated by the "ScreenID" parameter.

Component Version macOS Windows Linux Server iOS SDK License
Screenshot 1.0 ✅ Yes ✅ Yes ❌ No ❌ No ❌ No Paid
MBS( "Screenshot"; ScreenID; Format; Quality; Filename )   More


Parameter Description Example
ScreenID Zero Based index of the screens.
If blank, then 0 is assumed.
Use in range from 0 to MBS( "Screen.Count" )-1.
Format The format of the file (currently only JPEG is supported) JPEG
Quality The quality of the image. From 0 to 100. 80
Filename The desired file name.
The image is not written to disk. This file name is just added to the container for later export.


Returns the image as a container value so you can assign it to a container.


Takes a screenshot of the screen indicated by the "ScreenID" parameter.
Use "Set Field" to set the result of this function into any container field.
Updated for macOS 10.7 in plugin version 2.5.

Returns the image as container value, so you can assign it to a container field or save to disk with Container.WriteFile function.
Added multi screen support for Windows with v11.3.

See also Container.Screenshot to make screenshot of a layout object, WebView.Screenshot to make a screenshot of a web viewer and Window.Screenshot for a screenshot of a window.


Capture screen as JPEG:

ScreenID = 0;
Format = "JPEG";
Quality = 90;
Filename = "MyCoolFile"
ScreenID ;
Format ;
Quality ;

Put screenshot in field:

Set Variable [ $screenshot ; Value: MBS("Screenshot"; 0; "jpeg"; 90) ]
Set Field [ Contacts::Photo Container ; $screenshot ]

Get screenshot of second screen:

Set Field [ Contacts::Photo Container ; MBS("Screenshot"; 1) ]

See also

Created 18th August 2014, last changed 18th April 2022

Screen.Width - ScreenshotRect

Feedback: Report problem or ask question.

Start Chat