addmenuitem

Adds an action item to the given menu in the Compose user interface. addmenuitem is only available in the Compose GUI.

Syntax

addmenuitem(rbname, name, menutext, callback, tooltip, statustip)

addmenuitem(uiPopupMenu, name, menutext, callback, tooltip, statustip)

Inputs

rbname
The name of the ribbon menu.
Type: string
uiPopupMenu
The handle of the ribbon menu or pop-up menu.
Type: class
name
The action item's name; must be unique.
Type: string
menutext
The action item's text, which appears in the menu.
Type: string
callback
The name of the callback function, which gets called when the action is clicked.
Type: string
tooltip
The action item's tooltip.
Type: string
statustip
The action item's status tip that is displayed on the status bar.
Type: string

Outputs

uiAction
The handle to the action item.

Examples

Add an action item to the given menu:
pm=addribbonmenu('Test'); % create a 'Test' ribbon page as menu
ab = addmenuitem(pm,'Show Test Label','Show Test','HandleTest','','');
ac = addmenuitem('Test','Show Test Label 1', 'Show Test 1','HandleTest_1','','');

% create popup menus
pp=addpopupmenu('Test', 'Test 2'); % create a sub popup menu "Test 2" under ribbon page 'Test'
pp1=addpopupmenu(pp, 'Test 3'); % create a popup menu 'Test 3' under ribbon page 'Test'
% create a menu actions with label 'Show Test Label 2' and name 'Show Test 2' under sub popup menu 'Test 2'
ad = addmenuitem(pp,'Show Test Label 2','Show Test 2','HandleTest_2','A test 2 menu action','clicked Test 2');
% create a menu actions with label 'Show Test Label 3' and name 'Show Test 3' under sub popup menu 'Test 3'
ae = addmenuitem(pp1,'Show Test Label 3','Show Test 3','HandleTest_3','A test 3 menu action','clicked Test 3');

function HandleTest()
	disp('Show Test is handled');
end

function HandleTest_1()
	disp('Show Test 1 is handled');
end

function HandleTest_2()
	disp('Show Test 2 is handled');
end

function HandleTest_3()
	disp('Show Test 3 is handled');
end