Topics   All   Mac OS X (Only)   Windows (Only)   Linux (Only, Not)   iOS (Only, Not)  
Components   Crossplatform Mac & Win   Server (Not)   Client   Old   Guides   Examples
New in version: 6.1   6.2   6.3   6.4   6.5   7.0   7.1   7.2   7.3   7.4    Statistic  

MenuItem.SetState

Sets the state of the menu item.

Component Version macOS Windows Server FileMaker Cloud FileMaker iOS SDK
Menu 4.1 Yes Yes No No No

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

Parameters

Parameter Description Example value
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


MenuItem.SetSelectable   -   MenuItem.SetStrikeOut

Feedback: Report problem or ask question.




Links
MBS Xojo Plugins