Topics   All   MacOS (Only)   Windows (Only)   Linux (Only, Not)   iOS (Only, Not)  
Components   Crossplatform Mac & Win   Server   Client   Old   Deprecated   Guides   Examples   Videos
New in version: 10.0   10.1   10.2   10.3   10.4   10.5   11.0   11.1   11.2   11.3    Statistic    FMM    Blog  

Window.SetDockImage

Sets the dock image for a window.

Component Version macOS Windows Linux Server iOS SDK
Window 7.5 ✅ Yes ❌ No ❌ No ❌ No ❌ No
MBS( "Window.SetDockImage"; WindowRef { ; Image } )   More

Parameters

Parameter Description Example Flags
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
Image The image to use.
Can be container in various formats, e.g. PNG.
If empty, clears existing picture.
$MyImage Optional

Result

Returns OK or error.

Description

Sets the dock image for a window.
The miniaturized window image is the image displayed in the Dock when the window is minimized. If you did not assign a custom image to the window, the value of this property is empty.
When the user minimizes the window, the Dock displays this image in the corresponding Dock tile, scaling it as needed to fit in the tile. If you do not specify a custom image using this property, the Dock creates one for you automatically.
You can also set this property as needed to change the minimized window image. Typically, you would specify a custom image immediately prior to a window being minimized. You can set this image while the window is minimized to update the current image in the Dock. However, you should not use this property to create complex animations in the Dock.
Support for custom images is disabled by default. To enable support the plugin automatically sets the AppleDockIconEnabled key to true when updating the image. Due to this enable process, the function may only work the second time you call it after restarting FileMaker.

Examples

Set image for current window:

Set Variable [ $r ; Value: MBS( "Window.SetDockImage"; 0; Assets::Image) ]

See also

Release notes

Blog Entries

Created 10th November 2017, last changed 10th November 2017


Window.SetCurrentTag - Window.SetFocus

Feedback: Report problem or ask question.




Links
MBS FileMaker Plugins

Start Chat