Returns the attributes of a menu item or menu bar.

(Real-Time Module) You cannot use this function in VIs that run on RT targets.


icon

Inputs/Outputs

  • cstr.png item tag —

    item tag identifies the item whose attributes you want to return.

    The default is to return the menu bar attributes.

    Use application item tags to return application menu item attributes.

  • 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.
  • cerrcodeclst.png error in (no error) —

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

  • i1dstr.png submenu tags —

    submenu tags are the submenu item tags if the item has a submenu.

  • ignrn.png menu reference out —

    menu reference out returns menu reference unchanged.

  • istr.png item name —

    item name is the string that appears in the menu.

  • ibool.png enabled —

    If enabled is FALSE, the menu item is grayed out.

  • ierrcodeclst.png error out —

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

  • ibool.png checked —

    If checked is TRUE, the menu item has a checkmark next to it.

  • icclst.png short cut —

    short cut is the keyboard equivalent of selecting this menu item with a mouse.

  • ibool.png include Shift key? —

    If include Shift key? is TRUE, the shortcut includes the <Shift> key, in addition to the shortcut key.

  • ibool.png include Ctrl key? —

    If include Ctrl key? is TRUE, the shortcut includes the <Ctrl> key, in addition to the shortcut key. You can set include Ctrl key? to FALSE only if you select a function key, such as <F1>, <F2>, and so on, as the shortcut key. On macOS, the key included is <Command>. On Linux, the key included is <Alt>.

  • istr.png shortcut key —

    shortcut key describes the key associated with the shortcut.