App.SetDockIcon
---------------

Sets the image for the dock icon for this application.

| Component | Version | macOS | Windows | Linux | Server | iOS SDK |
|---|---|---|---|---|---|---|
| [App](component_App.md) | [3.2](newinversion32.md) | ✅ Yes | ❌ No | ❌ No | ❌ No | ❌ No |

MBS( "App.SetDockIcon"; Image ) 

**MBS**( **"App.SetDockIcon";** /\* Sets the image for the dock icon for this application. \*/  
**$Image**) /\* The image to use.   
Pass a container value with JPEG, TIFF, PNG or other image formats. \*/ 

### Parameters

| Parameter | Description | Example |
|---|---|---|
| Image | The image to use.    Pass a container value with JPEG, TIFF, PNG or other image formats. | $image |

### Result

Returns OK or error.

### Description

Sets the image for the dock icon for this application.  
Works with FileMaker Pro and runtimes.  
  
See also [App.SetProcessName](AppSetProcessName.md) to change the name.  
  
Pass empty value to clear image.  
### Examples

Change dock icon:

 Set Variable \[ $r ; Value:MBS ("App.SetDockIcon"; Globals::DockImage ) \]  
### See also

- [App.GetDockIcon](AppGetDockIcon.md)
- [App.SetProcessName](AppSetProcessName.md)
- [Icon.SetIcon](IconSetIcon.md)

### Release notes

- **Version 12.2**
    - Changed [App.SetDockIcon](https://www.mbsplugins.eu/AppSetDockIcon.shtml) to allow passing empty value to clear image.

### Example Databases

- [Mac only/Dock Tile](https://www.mbsplugins.eu/MBS-FileMaker-Plugin-Examples/Mac%20only/Dock%20Tile.shtml#4ScriptAnchor_)

### Blog Entries

- [MBS FileMaker Plugin, version 12.2pr4](https://www.mbsplugins.de/archive/2022-04-28/MBS_FileMaker_Plugin_version_1/monkeybreadsoftware_blog_filemaker)
- [MBS @ FMTraining.TV](https://www.mbsplugins.de/archive/2022-04-15/MBS_@_FMTrainingTV/monkeybreadsoftware_blog_filemaker)
- [Customize your FileMaker solution](https://www.mbsplugins.de/archive/2021-04-25/Customize_your_FileMaker_solut/monkeybreadsoftware_blog_filemaker)
- [More customization of FileMaker solutions](https://www.mbsplugins.de/archive/2016-02-07/More_customization_of_FileMake/monkeybreadsoftware_blog_filemaker)
- [MBS Filemaker Plugin, version 3.2pr9](https://www.mbsplugins.de/archive/2013-04-27/MBS_Filemaker_Plugin_version_3/monkeybreadsoftware_blog_filemaker)

This function checks for a license.

Created 18th August 2014 , last changed 23th April 2022

  
[App.SetDockBadgeLabel](AppSetDockBadgeLabel.md) - [App.SetProcessName](AppSetProcessName.md)

[HTML Version](AppSetDockIcon.shtml)