MenuItem.SetState
-----------------

Sets the state of the menu item.

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

MBS( "MenuItem.SetState"; Item; itemState ) 

**MBS**( **"MenuItem.SetState";** /\* Sets the state of the menu item. \*/  
**$Item**; /\* The reference to the menu item. Please create one with [MenuItem.CreateMenuItem](MenuItemCreateMenuItem.md) or [MenuItem.CreateSeparator](MenuItemCreateSeparator.md). \*/   
**$itemState**) /\* The new state; it should be one of Off, on or mixed.e.g. "mixed" \*/ 

### 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 |
| itemState | The new state; it should be one of Off, on or mixed. | "mixed" |

### Result

Returns OK or error.

### Description

Sets the state of the menu item.  
The image associated with the new state is displayed to the left of the menu item.  
See also [MenuItem.GetState](MenuItemGetState.md).  
Mixed state is not supported on Windows.  
On Mac the special values "bullet" and "diamond" sets state to on and switch to use bullet/diamond images.  
### Examples

Create menu item with mixed state:

 Set Variable \[$item ; Value:MBS ("[MenuItem.CreateMenuItem](MenuItemCreateMenuItem.md)"; "With State Mixed")\]  
Set Variable \[$r ; Value:MBS ("MenuItem.SetState"; $item ; "mixed")\]  
Set Variable \[$r ; Value:MBS ("[Menu.AddItem](MenuAddItem.md)"; $menu ; $item )\]  
Create menu item with on state:

 Set Variable \[$item ; Value:MBS ("[MenuItem.CreateMenuItem](MenuItemCreateMenuItem.md)"; "With State On")\]  
Set Variable \[$r ; Value:MBS ("MenuItem.SetState"; $item ; "on")\]  
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.GetState](MenuItemGetState.md)
- [MenuItem.SetEnabled](MenuItemSetEnabled.md)
- [MenuItem.SetFontName](MenuItemSetFontName.md)
- [MenuItem.SetItalic](MenuItemSetItalic.md)
- [MenuItem.SetSubMenu](MenuItemSetSubMenu.md)
- [MenuItem.SetTag](MenuItemSetTag.md)
- [MenuItem.SetTitle](MenuItemSetTitle.md)

### Example Databases

- [Menu/Popup Menu](https://www.mbsplugins.eu/MBS-FileMaker-Plugin-Examples/Menu/Popup%20Menu.shtml#2ScriptAnchor_)

### Blog Entries

- [More menu commands for FileMaker](https://www.mbsplugins.de/archive/2015-05-11/More_menu_commands_for_FileMak/monkeybreadsoftware_blog_filemaker)

This function checks for a license.

Created 18th August 2014 , last changed 11st May 2015

  
[MenuItem.SetSelectable](MenuItemSetSelectable.md) - [MenuItem.SetStrikeOut](MenuItemSetStrikeOut.md)

[HTML Version](MenuItemSetState.shtml)