Returns the menu item that is accessible through a given shortcut.

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

    You can obtain this refnum with the Current VI's Menubar function.
  • 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.

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

  • istr.png item tag —

    item tag is the tag of the menu item that matches the shortcut.

  • istr.png item path —

    item path describes the position of the item in the menu hierarchy, which is in the format of a list of menu tags separated by a colon (:).

    For example, on Windows, if you do not change the default shortcuts and you pass in <Ctrl-O> from the menu bar reference of a VI, item path returns File:Open.

  • ierrcodeclst.png error out —

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