DeleteMasterItem

Description

Removes a master menu item from the application menu.

Applies to

RibbonApplicationMenu controls

Syntax

controlname.DeleteMasterItem ( { Long ParentIndex, } Long Index )

Argument

Description

controlname

The name of the RibbonApplicationMenu control from which you want to remove the master menu item.

ParentIndex (optional)

The index of the master menu item (RibbonMenuItem) whose submenu you want to delete.

If not specified, the master menu item will be deleted; if specified to a valid value, the submenu item of the master menu item (whose index is ParentIndex) will be deleted; if specified to an invalid value, an error would occur and this operation would return -1.

Index

The index of the master menu item or submenu item which you want to delete. If index is invalid, an error would occur and this operation would return -1.

Return value

Integer.

Returns the number of items remaining in the list of values after the item is deleted if it succeeds and -1 if an error occurs. If any argument's value is null, returns null.

Examples

This example inserts a "MenuItem1" master menu item and a "SubMenuItem1" submenu item and then deletes them according to their index number.

Long ll_Return,ll_Index,ll_Index2
RibbonApplicationMenu lr_AppMenu
RibbonMenuItem lr_MenuItem1,lr_MenuItem2

lr_MenuItem1.Text = "MenuItem1"
lr_MenuItem2.Text = "SubMenuItem1"

ll_Index =  lr_AppMenu.InsertMasterItemLast(lr_MenuItem1)
ll_Index2 = lr_AppMenu.InsertMasterItemLast(ll_Index,lr_MenuItem2)
ll_Return = lr_AppMenu.DeleteMasterItem(ll_Index,ll_Index2)
ll_Return = lr_AppMenu.DeleteMasterItem(ll_Index)

See also

AddMasterSeparatorItem

ClearRecentItems

DeleteRecentItem

GetMasterItem

GetMasterItemCount

GetRecentItem

GetRecentItemCount

GetRecentTitle

InsertMasterItem

InsertMasterItemFirst

InsertMasterItemLast

InsertRecentItem

InsertRecentItemFirst

InsertRecentItemLast

SetMasterItem

SetRecentItem

SetRecentTitle