Components All New MacOS Windows Linux iOS
Examples Mac & Win Server Client Guides Statistic FMM Blog Deprecated Old

MenuItem.SetBackColor

Sets the back color of the menu item.

Component Version macOS Windows Linux Server iOS SDK
Menu 6.5 ❌ No ✅ Yes ❌ No ❌ No ❌ No
MBS( "MenuItem.SetBackColor"; item; Color )   More

Parameters

Parameter Description Example
item The reference to the menu item. Please create one with MenuItem.CreateMenuItem or MenuItem.CreateSeparator. $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"; "Red Color")]
Set Variable [$r; Value:MBS("MenuItem.SetBackColor"; $item; "#FF0000")]
Set Variable [$r; Value:MBS("Menu.AddItem"; $menu; $item)]

See also

Blog Entries

This function checks for a license.

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


MenuItem.SetAttributedTitle - MenuItem.SetBold