Waits until an event occurs, then executes the appropriate case to handle that event.
The Event Structure has one or more subdiagrams, or event cases. Only one event case executes when the structure executes to handle an event. You must place the Event Structure in a While Loop to handle multiple events.
Configure event cases and events from the Item tab. To select the events an event case handles, click Select handled events on the Item tab.
Event registration reference or a cluster of event registration references for dynamic event registration.
To enable this terminal, select Use dynamic events on the Item tab.
Use Register for Events to define events programmatically, and then wire the event registration reference to this terminal to access those events from within the Event Structure.
By default, the dynamic event registration terminal on the right border returns the same event registration reference you wire to the input of the dynamic event registration terminal on the left border. However, if you wire a different event registration reference to the input of the dynamic event registration terminal on the right, the terminal on the right no longer carries the same data as the terminal on the left.
You can use a Register For Events node inside of an event case to modify an existing event registration reference dynamically. To modify an existing event registration reference, you must wire event references to the Register For Events node that contain the same data types as the event references contained in the event registration reference you wire to the Register For Events node.
Border node that identifies the data the Event Structure returns when an event occurs.
Resize the node to view and select data elements. Time and Index are common to all events. Other data elements vary based on the event you configure.
The order of events in the Event Selector Label determines the Index of the events in an event case that handles more than one event. When more than one event source is configured for an event structure case, Index displays which item in the list of sources generated the event currently being handled. Use Control Reference to find more information on the source that generated the event.
Border node that identifies the event data you can modify before the user interface can process that data.
This node appears in the Event Structure cases that handle filter events. Resize the node to view inputs available for the filter event you select.
Filter events have names that end with a question mark to help you distinguish them from notify events. Use a filter event if you want to discard the event or interact with data associated with a particular user action on the panel before the Event Structure executes a subdiagram of code.
To change event data, wire and modify data items from the Event Data node to the Event Filter node. You can also change the event data by wiring new values to Event Filter node inputs. To completely discard an event, wire a True value to the Discard? input. If you do not wire a value to a data item of the Event Filter node, that data item remains unchanged.
The Event Structure can time out while waiting for notification of an event. The Event Structure executes the timeout event case you create if the structure times out. The Event Structure does not time out if you do not select the Timeout event for at least one event case.
There are two types of user interface events handled by the Event Structure: notify and filter.
Filter events have names that end with a question mark to help you distinguish them from notify events. In most cases, the VI generates an associated notify event after its corresponding filter event if no event case discarded the event. The notify event has the same name as its corresponding filter event but without the question mark.
The following table describes these types of events and when to use each type:
Register events to specify which events you want an Event Structure to handle.
When you register an event, the VI notifies the Event Structure when that particular event occurs. You can register for an event statically or dynamically. A VI that contains an Event Structure automatically performs static event registration when you run it. Use the Register for Events node to perform event registration for dynamic events.
The following table describes the types of event registration and when to use each type.
Where This Node Can Run:
Desktop OS: Windows
FPGA: Not supported
Web Server: Supported in VIs that run in a web application