List |
public bool WaitForListIdle( out int? listID, int? timeout = null )
null (or omitted) | use the default timeout period specified by ClientAPITimeout |
-1 | wait indefinitely for the event |
0 | do not wait, simply check if an event has already been reported |
> 0 | timeout period in ms |
true | if an event is reported within the specified timeout period. |
false | but only if timeout== 0 and no event has occurred. If timeout!= 0 and no event has occurred, a TimeoutException will be thrown. |
Exception | Condition |
---|---|
TimeoutException | Timeout occurred before the event. |
ThreadInterruptedException | The wait was interrupted prematurely. |
ListExecutionException | see12.7 Exceptions and Errors |
ExecutionException | see12.7 Exceptions and Errors |
FatalException | see12.7 Exceptions and Errors |
AbortedException | see12.7 Exceptions and Errors |
OutOfFieldException | see12.7 Exceptions and Errors |
Note that this function will throw a TimeoutException if no event is reported within the specified timeout period.
Use TryWaitForListIdle(NullableInt32, NullableInt32) if no exception is desired.
Waiting can be interrupted by calling InterruptWaitForListIdle.
Doing so will cause a ThreadInterruptedException.
Note, however, that the event does not imply that all of the micro-vectors generated by the list have been output yet ( WaitForListDone(NullableInt32, NullableInt32)).