Set String

Sets an edit box control contained in a cell to a specified string. The edit box must be of the type EditString.

Set String Inputs

Syntax: SS[TagName][Space][Text]

Set String Outputs

Status Codes Description
1

The command was executed successfully.

0

Unrecognized command.

-1

Invalid tag name.

-2

The input string is longer than the specified maximum string length in the EditString function or the cell does not contain an EditString function.

-3

Unable to set a read only tag.

-4

Wrong argument type.

-6

User does not have Full Access to execute the command.

Set String Example

  1. Assume cell B2 is populated as follows:

    B2 = EditString(20)

    Cell B2 is named Math_1.A1.

    The EditString control currently contains the text Before SS. The Easy Builder looks like this:

  2. To change this text to After SS using the Set String Native Mode command, issue the command SSMath_1.A1 After SS, as shown in the following telnet client window:

    The In-Sight sensor responds with 1, indicating that the command was successfully executed. The EditString control has been successfully changed from Before SS to After SS: