Monkeybread Software - MBS FileMaker Plugin: MenuItem.SetScriptAction

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

Sets which script is called if a menu item in this menu is selected.

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

MBS( "MenuItem.SetScriptAction"; item; FileName; ScriptName { ; ScriptParameter } ) More

Parameters

Parameter Description Example Flags

item The reference to the menu item. Please create one with MenuItem.CreateMenuItem or MenuItem.CreateSeparator. $item

FileName The filename of file which contains the script. "Menus.fmp12"

ScriptName The name of the script. "MenuScript"

ScriptParameter If you want a specific script parameter.
Default is to leave empty and get the ID fo the menu item.
You can store a value with the menu item via MenuItem.SetTag. Optional

Parameter	Description	Example	Flags
item	The reference to the menu item. Please create one with MenuItem.CreateMenuItem or MenuItem.CreateSeparator.	$item
FileName	The filename of file which contains the script.	"Menus.fmp12"
ScriptName	The name of the script.	"MenuScript"
ScriptParameter	If you want a specific script parameter. Default is to leave empty and get the ID fo the menu item. You can store a value with the menu item via MenuItem.SetTag.		Optional

Result

Returns OK or error.

Description

Sets which script is called if a menu item in this menu is selected.
You can use MenuItem.SetScriptAction to associate a script with individual items or use this function for a whole menu.
See also MenuItem.GetScriptFileName and MenuItem.GetScriptName.

With plugin version 6.0 or newer the script name can be a script ID number. In that case the plugin queries the script name for the given script ID. This allows to call scripts by ID and avoid problems if scripts are later renamed.

Examples

Add menu item with script to be called:

Set Variable [$item; Value:MBS("MenuItem.CreateMenuItem"; "Hello World")]
Set Variable [$r; Value:MBS("MenuItem.SetScriptAction"; $item; Get(FileName); "MenuScript")]
Set Variable [$r; Value:MBS("Menu.AddItem"; $menu; $item)]

Example Databases

Menu/Popup Menu

Blog Entries

Created 18th August 2014, last changed 2nd December 2016

MenuItem.SetRequireShift - MenuItem.SetSelectable

Feedback: Report problem or ask question.