Toolbar.InstallBackground
-------------------------

Installs a background for the toolbar.

| Component | Version | macOS | Windows | Linux | Server | iOS SDK |
|---|---|---|---|---|---|---|
| [Toolbar](component_Toolbar.md) | [4.3](newinversion43.md) | ✅ Yes | ❌ No | ❌ No | ❌ No | ❌ No |

### Deprecated

This function was [deprecated](deprecated.md).

MBS( "Toolbar.InstallBackground"; Image { ; Mode; DisableTitle } ) 

**MBS**( **"Toolbar.InstallBackground";** /\* Installs a background for the toolbar. \*/  
**$Image**; /\* The image to you. Pass a container value with JPEG, TIFF, PNG or other image formats.e.g. $img \*/   
**$Mode**; /\* Optional; Can be 0 to stretch (default) or 1 to left align image.e.g. 0 \*/   
**$DisableTitle**) /\* Optional; If 1, we do not draw the window title on top of the image.e.g. 0 \*/ 

### Parameters

| Parameter | Description | Example | Flags |
|---|---|---|---|
| Image | The image to you. Pass a container value with JPEG, TIFF, PNG or other image formats. | $img |  |
| Mode | Can be 0 to stretch (default) or 1 to left align image. | 0 | Optional |
| DisableTitle | If 1, we do not draw the window title on top of the image. | 0 | Optional |

### Result

Returns OK or error.

### Description

Installs a background for the toolbar.  
There is currently only one style for all FileMaker windows on macOS.  
We draw an image below the toolbar buttons. Either we stretch it to full width we align it to left and fill the space on the right with last pixel colors.  
There are little redraw issues, especially when resizing window.  
  
Currently doesn't work in FileMaker 14 and newer. If you need that to work, please contact us.  
### Release notes

- **Version 11.2**
    - Deprecated [Toolbar.InstallBackground](https://www.mbsplugins.eu/ToolbarInstallBackground.shtml) function.

### Blog Entries

- [MBS FileMaker Plugin, version 11.2pr8](https://www.mbsplugins.de/archive/2021-05-14/MBS_FileMaker_Plugin_version_1/monkeybreadsoftware_blog_filemaker)
- [MBS FileMaker Plugin 4.3 for OS X/Windows - More than 2700 Functions In One Plugin](https://www.mbsplugins.de/archive/2014-09-16/MBS_FileMaker_Plugin_43_for_OS/monkeybreadsoftware_blog_filemaker)
- [Toolbar functions for FileMaker on Mac](https://www.mbsplugins.de/archive/2014-08-27/Toolbar_functions_for_FileMake/monkeybreadsoftware_blog_filemaker)

This function checks for a license.

Created 25th August 2014 , last changed 13th May 2021

  
[Toolbar.Install](ToolbarInstall.md) - [Toolbar.Register](ToolbarRegister.md)

[HTML Version](ToolbarInstallBackground.shtml)