Topics   All functions   Mac OS X   Windows   Crossplatform   Server   Components   Guides   Statistic  
New in version: 3.0   3.1   3.2   3.3   3.4   3.5   4.0   4.1   4.2   4.3  

Window.FindByIndex

Component: Window
Version: 1.0
Mac OS X: Yes
Windows: Yes
Server: 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) & ")"

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) & ")")

Feedback: Report problem or ask question.




Links
MBS Real Studio Plugins - Nachhilfe in Andernach