Topics   All   Mac OS X (Only)   Windows (Only)   Linux (Only, Not)   iOS (Only, Not)  
Components   Crossplatform Mac & Win   Server   Client   Old   Guides   Examples
New in version: 8.0   8.1   8.2   8.3   8.4   8.5   9.0   9.1   9.2   9.3    Statistic  


Creates screenshot from a window.

Component Version macOS Windows Server FileMaker Cloud FileMaker iOS SDK
Window 5.4 Yes Yes No No Yes
MBS( "Window.Screenshot"; WindowRef { ; MarginLeft; MarginTop; MarginRight; MarginBottom; ImageType; Filename } )   More


Parameter Description Example value
WindowRef Window Reference is the unique OS level window ID. You can obtain this by using the Window.FindByTitle or Window.FindByIndex functions. Pass zero to access the frontmost window. 0
MarginLeft Optional
The margin from left to cut away border.
MarginTop Optional
The margin from top to cut away border.
MarginRight Optional
The margin from right to cut away border.
MarginBottom Optional
The margin from bottom to cut away border.
ImageType Optional
The type of image to return. Either JPEG, PNG, GIF or BMP. Default is JPEG.
Filename Optional
The filename to use for the picture.
Default is "image" with the extension matching the image type.
The image is not written to disk. This file name is just added to the container for later export.


Returns image or error.


Creates screenshot from a window.
Returns the image as container value, so you can assign it to a container field or save to disk with Container.WriteFile function.
Margins are different for Mac and Windows.

Added iOS support in version 8.5, but margins are not supported there, so we always take full screen.


Creates screenshot:

MBS("Window.Screenshot"; Get(WindowName); Window Screenshot::Margin Left; Window Screenshot::Margin Top; Window Screenshot::Margin Right; Window Screenshot::Margin Bottom)

Screenshot of current window as JPEG:

MBS( "Window.Screenshot"; 0)

See also

Example Databases

Blog Entries

Created 27th October 2015, last changed 26th April 2019

Window.RunToolbarCustomizationPalette   -   Window.Scrollbar.GetScrollElasticity

Feedback: Report problem or ask question.

MBS Xojo Plugins