| Description: | Sets the next state to start when the action script completes. |
| Returns: | Nothing |
Usage:  |
Script Only. |
| Function Groups: | Compilation and On-Line Modifications, Logic Control, State |
| Related to: | FirstState |
| Format: |
ForceState(State) |
| Parameters: |
| State |
| Required. Any text expression giving the name of the state to start upon completion of the script. |
| Comments: | This statement does not act like an exit point from the script - the script will still run in its entirety. If, however, the script transfer condition did not specify a different state to transfer to, this function will stop the current state. Multiple ForceState statements may be executed in a script, with the last one executed setting the state to which the module will switch. |
Example:
If TimeOut(1, 1) Main;
[
IfThen(level < 10, ForceState("Exit"));
]
After one second this statement will cause a state transfer to Main. However, if level is less than 10 at that time, the next state will become Exit rather than Main.
