Table Of Contents

Insert Menu Items (G Dataflow)

Version:
Last Modified: January 12, 2018

Adds items to the menu.

connector_pane_image
datatype_icon

menu tag

Tag of the submenu in which to insert items.

Default: Empty string — Causes this node to insert the items at the top level of the menu.

datatype_icon

menu reference

Reference to a menu bar in a VI.

datatype_icon

error in

Error conditions that occur before this node runs.

The node responds to this input according to standard error behavior.

Standard Error Behavior

Many nodes provide an error in input and an error out output so that the node can respond to and communicate errors that occur while code is running. The value of error in specifies whether an error occurred before the node runs. Most nodes respond to values of error in in a standard, predictable way.

error in does not contain an error error in contains an error
If no error occurred before the node runs, the node begins execution normally.

If no error occurs while the node runs, it returns no error. If an error does occur while the node runs, it returns that error information as error out.

If an error occurred before the node runs, the node does not execute. Instead, it returns the error in value as error out.

Default: No error

datatype_icon

item names

Names of the items to insert.

You can wire either item names, or item tags, or both. If you wire only one of the two inputs, item names and item tags have the same values.

This input accepts a string or a 1D array of strings.

Default: Empty string — Causes this node to use the same value as item tags for item names. If item tags and item names are empty strings, this node does not insert any item into the menu.

datatype_icon

item tags

Tags of the items to insert.

This input accepts a string or a 1D array of strings.

You can wire either item names, or item tags, or both. If you wire only one of the two inputs, item names and item tags have the same values.

You can insert a menu separator using the APP_SEPARATOR tag. The tag of each menu item must be unique. This node appends numbers to any menu item tags that are the same or already exist.

Default: Empty string — Causes this node to use the same value as item names for item tags. If both are empty strings, this node does not insert any item into the menu.

datatype_icon

after item

Position to insert the items.

This input accepts a string or a 32-bit signed integer.

after item can be a tag of an existing item or a position index in the menu. Refer to the following table to determine how to wire after item.

Position to Insert the Items Value to Wire to after item
After an existing item Tag of the existing item
At the beginning of the menu An integer less than zero
At the end of the menu An integer larger than the number of items in the menu or tag of the last item in the menu

If the node does not find an existing item with the tag you specify, this node inserts the items at the end of the menu.

Default: Empty string — Causes this node to insert the items at the end of the menu.

datatype_icon

menu reference out

Reference to the menu bar in a VI.

datatype_icon

error out

Error information.

The node produces this output according to standard error behavior.

Standard Error Behavior

Many nodes provide an error in input and an error out output so that the node can respond to and communicate errors that occur while code is running. The value of error in specifies whether an error occurred before the node runs. Most nodes respond to values of error in in a standard, predictable way.

error in does not contain an error error in contains an error
If no error occurred before the node runs, the node begins execution normally.

If no error occurs while the node runs, it returns no error. If an error does occur while the node runs, it returns that error information as error out.

If an error occurred before the node runs, the node does not execute. Instead, it returns the error in value as error out.
datatype_icon

item tags out

Tags of the inserted items.

This output can return a string or a 1D array of strings.

Where This Node Can Run:

Desktop OS: Windows

FPGA: Not supported

Web Server: Not supported in VIs that run in a web application


Recently Viewed Topics