Owning Palette: Menu Functions
Requires: Base Development System
Deletes menu items from the menu or a submenu within the menu.
(Real-Time Module) You cannot use this function in VIs that run on RT targets.
Add to the block diagram | Find on the palette |
menu reference is the reference to a menu bar in a VI or to a shortcut menu of a control. You can obtain this refnum with the Current VI's Menubar function or with the MenuRef event data field of menu events. | |
menu tag specifies the submenu from which to delete items. If you do not specify menu tag, the function deletes all items from the menu. | |
items can be a tag (string) of an existing item, an array of tags of existing items, a position index (zero-based integer) of an item in the menu, or an array of position indexes of items in the menu. The default is to delete all the items in the menu or submenu specified by menu tag. If any of the specified items have a submenu, the function deletes the submenu and all its contents. Use application item tags for menus or shortcut menus to delete application menu items. Because separators do not have unique tags, you can delete them using their positional indexes. | |
error in describes error conditions that occur before this node runs. This input provides standard error in functionality. | |
menu reference out returns menu reference unchanged. | |
error out contains error information. This output provides standard error out functionality. |
Refer to the Customizing the Menubar VI in the labview\examples\Dialog and User Interface\Menu\Customizing the Menubar directory for an example of using the Delete Menu Items function.