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.


icon

Inputs/Outputs

  • cgnrn.png menu reference

    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.

  • cstr.png menu tag

    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.

  • cstr.png items

    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.

  • cerrcodeclst.png error in (no error)

    error in describes error conditions that occur before this node runs. This input provides standard error in functionality.

  • ignrn.png menu reference out

    menu reference out returns menu reference unchanged.

  • ierrcodeclst.png error out

    error out contains error information. This output provides standard error out functionality.

  • Examples

    Refer to the following example files included with LabVIEW.

    • labview\examples\Dialog and User Interface\Menu\Customizing the Menubar\Customizing the Menubar.vi