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<CellName> <Text>

Note: The Set String command requires a space between the cell ID and text string arguments.

Set String Outputs

Status Codes Description
1

The command was executed successfully.

0

Unrecognized command.

-1

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

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

    The cell B2 is published with the name StringIn.

    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 SSStringIn After SS, as shown in the following Telnet client window:

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