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[Column][Row][String]

Parameter Description

Column

The column letter of the cell value to set (A to Z).

Row

The row number of the cell value to set. The row number must contain a three-digit number (000 to 399).

String

The string to set.

Set String Outputs

Status Codes Description
1

The command was executed successfully.

0

Unrecognized command.

-1

The cell ID is invalid.

-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.

-6

User does not have Full Access to execute the command. For more information, see User Access Settings Dialog.

Set String Example

  1. Assume cell B2 is populated as follows:

    B2 = EditString(20)

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

  2. To change this text to After SS using the Set String Native Mode command, issue the command SSB002After 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: