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
-
Assume cell B2 is populated as follows:
B2 = EditString(20)
The EditString control currently contains the text Before SS. The spreadsheet looks like this:
-
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: