Components All New MacOS Windows Linux iOS
Examples Mac & Win Server Client Guides Statistic FMM Blog Deprecated Old


Returns the Window Reference for a window specified by the Index parameter.

Component Version macOS Windows Linux Server iOS SDK
Window 1.0 ✅ Yes ✅ Yes ❌ No ❌ No ❌ No
MBS( "Window.FindByIndex"; Index )   More


Parameter Description Example
Index 0 based index of the current windows open in FileMaker. If no value is entered then 0 is assumed. Using 0 will give the window reference for the current window. See caution in description


Returns window reference number or error.


Returns the Window Reference for a window specified by the Index parameter.
The Window Reference is a unique ID handed out by the operating system. It is used by the rest of the Window functions. Caution: Passing 0 for Index will grab the front most window which should be your FileMaker window, but it could be any window including dialogs. This is a particular problem with the "Data Viewer" which is always in the front. Window.FindByTitle was added to version 1.1 as a more reliable way of getting the Window.Ref
The window reference is only valid until the window is closed.

On normal FileMaker on desktop you can use Get(WindowName), but on FileMaker Server the name includes the server name, so you need to use: Get(WindowName) & " (" & Get(HostName) & ")"

Window reference numbers are starting at 15000 and counting up for each new window.


Find the window ref

MBS( "Window.FindByIndex" ; 0 )

Find window reference on FileMaker Server where FileMaker includes server name in window name:

MBS( "Window.FindByTitle"; Get(WindowName) & " (" & Get(HostName) & ")")

See also

Blog Entries

This function is free to use.

Created 18th August 2014, last changed 9th January 2015

Window.Fade - Window.FindByTitle