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.4   8.5   9.0   9.1   9.2   9.3   9.4   9.5   10.0   10.1    Statistic  


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

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


Parameter Description Example value
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

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

Window.Fade   -   Window.FindByTitle

Feedback: Report problem or ask question.

MBS Xojo Chart Plugins