Monkeybread Software - MBS FileMaker Plugin: Menu.DefineQuickMenuXML

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

Menu.DefineQuickMenuXML

Defines a menu based on a xml description.

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

MBS( "Menu.DefineQuickMenuXML"; XML ) More

Parameters

Parameter Description Example

XML The description XML.

Parameter	Description	Example
XML	The description XML.

Result

Returns menu reference or error.

Description

Defines a menu based on a xml description.
The xml has a root entry called "menu". Each menu entry can have attributes title, tag, groupID, scriptname, filename and modifierkeys. A menu can have subnodes of name menu or item. The item can have attributes title, tag, scriptname, filename, tag, enabled, selectable, Separator, mark, style, GroupID or modifierkeys.

Modifierkeys can include shift, control, option or command.
Mark can include mixed, bullet, diamond or checked.
Style can include bold, italic or underline.
If an item has name "-" or Separator=1 attribute, the plugin will mark it as being a separator.

If the root menu entry has a name, we can use that name as menu reference.
Added FontColor and BackColor in version 9.4.

Examples

Defines a quick menu with XML:

MBS( "Menu.DefineQuickMenuXML"; "<menu name=\"menue\">
<menuitem name=\"Red\" value=\"1\" />
<menuitem name=\"Blue\" value=\"2\" />
<menuitem name=\"Yellow\" value=\"3\" />
</menu>" )

Define a menu with submenus:

MBS( "Menu.DefineQuickMenuXML"; "<menu name=\"menue\">
<submenu name=\"Warm Colors\">
<menuitem name=\"Red\" value=\"1\" />
<menuitem name=\"Blue\" value=\"2\" />
<menuitem name=\"Yellow\" value=\"3\" />
</submenu>
<submenu name=\"Cool Colors\">
<menuitem name=\"Blue\" value=\"4\" />
<menuitem name=\"Green\" value=\"5\" />
<menuitem name=\"Purple\" value=\"6\" />
</submenu>
</menu>\")" )

Example Databases

Menu/DefineQuickMenu with XML

Blog Entries

Release notes

Version 10.4
- Improved text encoding handling for XML Parsing in XML functions, Menu.DefineQuickMenuXML and Clipboard functions.
Version 9.4
- Added new keys FontColor and BackColor elements to XML for Menu.DefineQuickMenuXML to define colors.

Created 6th June 2015, last changed 24th July 2019

Menu.DefineQuickMenu - Menu.FindItemWithTag

Feedback: Report problem or ask question.