WriteMSStack

Appends a user-specified string from the spreadsheet to the operational status information in buffer 0 of the Machine Status Stack whenever the spreadsheet is updated. For more information, see Sensor Status View.

To shift the entire contents of each buffer to the next buffer in the Machine Status Stack, use the PushMSStack function. For more information, see PushMSStack.

Data stored in the stack is accessed using the GetMSBuffer command over a Native Mode connection or from the Machine Status Port. For more information, see GetMSBuffer and Machine Status Port.

Note: Jobs containing this function that are saved in In-Sight Explorer 3.3.0 or higher are only compatible with In-Sight Explorer 3.3.0 and higher.

WriteMSStack Inputs

Syntax: WriteMSStack(Event,String)

Parameter Description

Event

Specifies the 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.
Note: When the default Event reference is deleted, the value is replaced by a checkbox. If another cell is referenced as an event, the function will conditionally run based on the referenced cell. If the checkbox is enabled, the function will always run when any inputs to the function are updated.

String

A string or a reference to a cell containing a string. The maximum string length is 255 characters, including characters used as delimiters. For example, comma (,), semicolon (;), Carriage Return/Line Feed (CRLF), etc. User-defined XML tags can also be included in the string.

WriteMSStack Outputs

Returns

An MSStack data structure containing the text to append, or #ERR if the input String is invalid.