Topics   All   Mac OS X (Only)   Windows (Only)   Linux (Only, Not)   iOS (Only, Not)  
Components   Crossplatform Mac & Win   Server (Not)   Client   Old   Guides   Examples
New in version: 6.1   6.2   6.3   6.4   6.5   7.0   7.1   7.2   7.3   7.4    Statistic  

Window.FindByIndex

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 )

Parameters

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

Result

Returns window reference number or error.

Description

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.

Examples

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


Window.Fade   -   Window.FindByTitle

Feedback: Report problem or ask question.




Links
MBS Xojo Plugins