removemenuitem

Removes an action item from the given menu in the Activate user interface. removemenuitem is only available in the Activate GUI.

Syntax

removemenuitem(rbname, name, removeparentifempty)

removemenuitem(uiAction, removeparentifempty)

Inputs

rbname
The name of the ribbon menu.
Type: string
name
The name of the action item.
Type: string
removeparentifempty
An optional argument. If true, removes the parent if it's the only item. Default = false.
Type: Boolean
uiAction
The handle to the action.
Type: class

Examples

Remove an action item from 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
			
removemenuitem('Test','Show Test Label 1'); % remove action by specifying action label
removemenuitem(ad); % remove by handle