tsc_ITsModesMonitor

This interface is used to handle tsc_TsModes related events.  Any class may subclass of this interface, in addition to any other monitor interfaces plus any regular base class.

Use an instance of the class by passing it into a tsc_TsModes method that you wish to monitor the progress of.  See tsc_TsModes for methods which take this type.

Event handlers

Any of the following event handlers may be implemented by overriding the method.  Note that these handlers do not supply information about the event; this is a performance consideration - the event sender does not know what the handler wishes to do and therefore does not waste time setting up interfaces that may never be used.  Rather, the event handler should "pull" the information it needs, when it needs it.

virtual void OnOnTsModesFail (tsc_TsModes* sender);
Called when one or more of the commands implied by a tsc_TsModes action has failed.  Supplies the tsc_TsModes object that issued the request.

virtual void OnTsModesTimeout (tsc_TsModes* sender);
Called when one or more of the commands implied by a tsc_TsModes action has timed out.  Supplies the tsc_TsModes object that issued the request.

virtual void OnTsModesComplete (tsc_TsModes* sender);
Called when all commands have completed.  If the tsc_TsModes method causing this event was Measure or StartMeasure, you can call modes->GetMeasureResult() to obtain the resulting measurement.

virtual void OnTsModesMeasurementComplete(tsc_TsModes* sender);
Called when the measurement has completed.  You can call modes->GetMeasureResult() to obtain the resulting measurement.

virtual void OnTsModesFailWithError (tsc_TsModes* modes, x_Code failureReason);
Available in SC version 2.31 and higher.
Called when the operation has failed, and provides an x_Code failure reason. The V1 OnTsModesFail method is also called.