MenuItem.CreateMenuItem

Creates a new menu item.

Parameters

Parameter	Description	Example	Flags
Title	The title of the menu item.	"Hello World"	Optional
keyEquivalent	Optional, a string representing a keyboard key to be used as the key equivalent.	"T"	Optional

Result

Returns menu item reference number or error.

Description

Examples

Show a context menu based on a table with menu entries:

# go to layout with menu entries
Go to Layout [ “REP” (REP Reports) ]
# this script can be called with various groups
Set Variable [ $type ; Value: Get(ScriptParameter) ]
# make a new menu
Set Variable [ $menu ; Value: MBS( "Menu.CreateMenu") ]
# loop over records
Go to Record/Request/Page [ First ]
Loop
    # if group matches
    If [ REP Reports::Group = $type ]
        # add new menu item with title from table
        Set Variable [ $item ; Value: MBS( "MenuItem.CreateMenuItem"; REP Reports::LabelReport) ]
        # define which script to call if menu item is selected
        Set Variable [ $r ; Value: MBS( "MenuItem.SetScriptAction"; $item; Get(FileName); REP Reports::Script ) ]
        # add item to menu
        Set Variable [ $r ; Value: MBS( "Menu.AddItem"; $menu; $item ) ]
    End If
    # next record?
    Go to Record/Request/Page [ Next ; Exit after last ]
End Loop
# switch layout back
Go to Layout [ original layout ]
# Show menu
Set Variable [ $r ; Value: MBS( "Menu.PopUp"; $menu; "mouse") ]
# Cleanup memory
Set Variable [ $r ; Value: MBS( "Menu.Release"; $menu) ]

See also

• MenuItem.SetRequireCommand
• MenuItem.SetRequireOption
• MenuItem.SetRequireShift
• MenuItem.SetState
• MenuItem.SetStrikeOut
• MenuItem.SetSubMenu
• MenuItem.SetTag
• MenuItem.SetTitle
• MenuItem.SetToolTip
• MenuItem.SetURL

Example Databases

• Mac and iOS/Data Detector
• Menu/Popup Menu

Blog Entries

• Evaluate vs. Script Trigger
• Tip of the day: Build contextual menu in FileMaker from a table
• Colors for Menus in FileMaker

This function checks for a license.

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

Menu.SetURL - MenuItem.CreateSeparator