MenuItem.SetBackColor
---------------------

Sets the back color of the menu item.

| Component | Version | macOS | Windows | Linux | Server | iOS SDK |
|---|---|---|---|---|---|---|
| [Menu](component_Menu.md) | [6.5](newinversion65.md) | ❌ No | ✅ Yes | ❌ No | ❌ No | ❌ No |

MBS( "MenuItem.SetBackColor"; Item; Color ) 

**MBS**( **"MenuItem.SetBackColor";** /\* Sets the back color of the menu item. \*/  
**$Item**; /\* The reference to the menu item. Please create one with [MenuItem.CreateMenuItem](MenuItemCreateMenuItem.md) or [MenuItem.CreateSeparator](MenuItemCreateSeparator.md). \*/   
**$Color**) /\* A color value.   
This can be a string in the following format "HSL h s l a", "YUV y u v a", "RGB r g b a", "MONO m a", "GRAY g a" or "COLOR R G B a". Alpha value a is optional. Range of values is 0 to 1.0 except if you use COLOR where RGB values are 0 to 255.  
Starting with version 5.4 of our plugin, you can use hex notation. # followed by 2 digits for red, green, blue and optional alpha, e.g. #FF0000 for full red.e.g. "RGB 1 0 0" \*/ 

### Parameters

| Parameter | Description | Example |
|---|---|---|
| Item | The reference to the menu item. Please create one with [MenuItem.CreateMenuItem](MenuItemCreateMenuItem.md) or [MenuItem.CreateSeparator](MenuItemCreateSeparator.md). | $item |
| Color | A color value.    This can be a string in the following format "HSL h s l a", "YUV y u v a", "RGB r g b a", "MONO m a", "GRAY g a" or "COLOR R G B a". Alpha value a is optional. Range of values is 0 to 1.0 except if you use COLOR where RGB values are 0 to 255.   Starting with version 5.4 of our plugin, you can use hex notation. # followed by 2 digits for red, green, blue and optional alpha, e.g. #FF0000 for full red. | "RGB 1 0 0" |

### Result

Returns OK or error.

### Description

Sets the back color of the menu item.  
Currently only used on Windows.   
On Mac it would only color the area where the text is and not the whole menu item, so this feature is disabled for Mac.  
### Examples

Creates a menu item for background color:

 Set Variable \[$item ; Value:MBS ("[MenuItem.CreateMenuItem](MenuItemCreateMenuItem.md)"; "Red Color")\]  
Set Variable \[$r ; Value:MBS ("MenuItem.SetBackColor"; $item ; "#FF0000")\]  
Set Variable \[$r ; Value:MBS ("[Menu.AddItem](MenuAddItem.md)"; $menu ; $item )\]  
### See also

- [Menu.AddItem](MenuAddItem.md)
- [MenuItem.CreateMenuItem](MenuItemCreateMenuItem.md)
- [MenuItem.CreateSeparator](MenuItemCreateSeparator.md)
- [MenuItem.GetBackColor](MenuItemGetBackColor.md)
- [MenuItem.GetFontColor](MenuItemGetFontColor.md)
- [MenuItem.SetFontColor](MenuItemSetFontColor.md)

### Blog Entries

- [MBS FileMaker Plugin, version 6.5pr1](https://www.mbsplugins.de/archive/2016-10-04/MBS_FileMaker_Plugin_version_6/monkeybreadsoftware_blog_filemaker)

This function checks for a license.

Created 1st October 2016 , last changed 18th March 2017

  
[MenuItem.SetAttributedTitle](MenuItemSetAttributedTitle.md) - [MenuItem.SetBold](MenuItemSetBold.md)

[HTML Version](MenuItemSetBackColor.shtml)