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.2   6.3   6.4   6.5   7.0   7.1   7.2   7.3   7.4   7.5    Statistic  

MenuItem.CreateMenuItem

Creates a new menu item.

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

MBS( "MenuItem.CreateMenuItem" { ; Title; keyEquivalent } )

Parameters

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

Result

Returns menu item reference number or error.

Description

Creates a new menu item.
You later need to release it with MenuItem.Release.
Menu item reference numbers are starting at 11000 and counting up for each new menu item.

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

Example Databases


Menu.SetURL   -   MenuItem.CreateSeparator

Feedback: Report problem or ask question.




Links
MBS Xojo Plugins