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.FlashWindow

Flashes the specified window one time.

Component Version macOS Windows Server FileMaker Cloud FileMaker iOS SDK
Window 6.1 No Yes No No No

MBS( "Window.FlashWindow"; WindowRef { ; Invert } )

Parameters

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
Invert Optional
If this parameter is 1, the window is flashed from one state to the other. If it is 0, the window is returned to its original state (either active or inactive).
When an application is minimized and this parameter is 1, the taskbar window button flashes active/inactive. If it is 0, the taskbar window button flashes inactive, meaning that it does not change colors. It flashes, as if it were being redrawn, but it does not provide the visual invert clue to the user.
1

Result

Returns 1, 0 or error.

Description

Flashes the specified window one time.
It does not change the active state of the window.

The return value specifies the window's state before the call to the FlashWindow function. If the window caption was drawn as active before the call, the return value is nonzero. Otherwise, the return value is zero.

Flashing a window means changing the appearance of its caption bar as if the window were changing from inactive to active status, or vice versa. (An inactive caption bar changes to an active caption bar; an active caption bar changes to an inactive caption bar.)
Typically, a window is flashed to inform the user that the window requires attention but that it does not currently have the keyboard focus.
The FlashWindow function flashes the window only once; for repeated flashing, the application should create a system timer.

Please use the main window from FileMaker, not the window of solution.

Examples

Flash Window:

MBS( "Window.FlashWindow"; "FileMaker Pro Advanced"; 1)

See also

Example Databases


Window.FindByTitle   -   Window.GetAlpha

Feedback: Report problem or ask question.




Links
MBS Xojo Plugins