# ReadMessage

Reads a string sent with the Send Message command through a Native Mode connection. The function Functions are tools that are available in Spreadsheet for processing and analyzing acquisitions or other results. You can add functions to your Spreadsheet job to create tool chains and produce results for specific applications. reads the string each time the specified event occurs.

Note: If the Native Mode connection is over a serial port, the serial port Mode must be set to Native.
Inputs

The ReadMessage function has the following syntax:

ReadMessage(Event)

See the table for a description of the available parameters.

Parameter | Description
--- | ---
Event | An external event that forces an update. This parameter must be a reference to one of the following: The Image data structure in cell A0 , containing the AcquireImage function. For more information, see AcquireImage. A cell containing an Event function. For more information, see Event. A cell containing a Button function. For more information, see Button.

Outputs

Returns | A Message data structure containing the text string to read, or #ERR if the input Event value is invalid.