Sets the attributes of a menu item.

Unwired attributes remain unchanged.

(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 menu item you want to set attributes for.

    If item tag is not valid, the function returns an error. Use application item tags to set attributes for application menu items.
  • 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 item name —

    item name is the string that appears in the menu.

  • cbool.png enabled —

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

  • cerrcodeclst.png error in (no error) —

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

  • cbool.png checked —

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

  • ccclst.png short cut —

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

  • cbool.png include Shift key? —

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

  • cbool.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.

    (macOS) The key included is <Command>. (Linux) The key included is <Alt>.
  • cstr.png shortcut key —

    shortcut key describes the key associated with the shortcut.

  • 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.