Set Region: Spreadsheet View
Sets an edit region control contained in a cell; the edit region control must be an EditRegion function.
Set Region Inputs
Syntax: SR[Column][Row][Row][Space][Col][Space][High][Space][Wide][Space][Angle][Space][Curve]
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 consist of three digits (000 to 399). |
Row | The x-offset of the origin, in image coordinates. |
Space | A blank space to separate the value from the next value. |
Col | The y-offset of the origin, in image coordinates. |
Space | A blank space to separate the value from the next value. |
High | The dimension along the region's x-axis. |
Space | A blank space to separate the value from the next value. |
Wide | The dimension along the region's y-axis. |
Space | A blank space to separate the value from the next value. |
Angle | The orientation, in image coordinates. |
Space | A blank space to separate the value from the next value. |
Curve |
The angle of orientation, in the image coordinate system. |
Set Region Outputs
Returns a status code. The status codes are:
Status Codes | Description |
---|---|
1 |
The command was executed successfully. |
0 |
Unrecognized command. |
-1 |
The cell ID is invalid. |
-2 |
The command could not be executed because the specified cell does not contain an edit region control, or the edit region control was not created by the EditRegion function. |
-6 |
User does not have Full Access to execute the command. For more information, see User Access Settings Dialog. |
Set Region Example
The command to set an edit region contained in cell A2 to a new location and dimensions.
-
Assume cell A2 is populated as follows: A2 = EditRegion($A$0,0,0,0,1,1,1,1,"Region",0)
The spreadsheet looks like this:
-
To change the region's location and dimensions using the Set Region Native Mode command; issue the command SRA002437.0 581.2 333.12 441 2 2.3as shown in the following telnet client window:
The In-Sight sensor responds with 1,indicating that the command was successfully executed: