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.SetState

Sets the state of the menu item.

Component Version macOS Windows Linux Server FileMaker iOS SDK
Menu 4.1 Yes Yes No No No
MBS( "MenuItem.SetState"; item; itemState )   More

Parameters

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

Create menu item with on state:

Set Variable [$item; Value:MBS("MenuItem.CreateMenuItem"; "With State On")]
Set Variable [$r; Value:MBS("MenuItem.SetState"; $item; "on")]
Set Variable [$r; Value:MBS("Menu.AddItem"; $menu; $item)]

See also

Example Databases

Blog Entries

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


MenuItem.SetSelectable   -   MenuItem.SetStrikeOut

Feedback: Report problem or ask question.



Links
MBS FileMaker Plugins

Start Chat