Monkeybread Software - MBS FileMaker Plugin: MenuItem.SetBackColor

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: 9.3 9.4 9.5 10.0 10.1 10.2 10.3 10.4 10.5 10.6 Statistic FMM Blog

MenuItem.SetBackColor

Sets the back color of the menu item.

Component	Version	macOS	Windows	Linux	Server	FileMaker 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"

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)]

Blog Entries

MBS FileMaker Plugin, version 6.5pr1

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

MenuItem.SetAttributedTitle - MenuItem.SetBold