OpenTAP 9.24
API Reference
Public Member Functions | Protected Member Functions | List of all members
OpenTap.ResultListener Class Reference

Abstract class forming the basis for all ResultListeners. More...

Inheritance diagram for OpenTap.ResultListener:
OpenTap.Resource OpenTap.IResultListener OpenTap.IEnabledResource OpenTap.ValidatingObject OpenTap.IResource OpenTap.INotifyActivity OpenTap.IResource OpenTap.ITapPlugin OpenTap.IResource OpenTap.IValidatingObject OpenTap.LogResultListener OpenTap.TestPlanRunSummaryListener

Public Member Functions

virtual void OnTestPlanRunStart (TestPlanRun planRun)
 Called when a test plan starts. More...
 
virtual void OnTestPlanRunCompleted (TestPlanRun planRun, System.IO.Stream logStream)
 Called when test plan finishes. At this point no more results will be sent to the result listener from the test plan run.
More...
 
virtual void OnTestStepRunStart (TestStepRun stepRun)
 Called just before a test step is started. More...
 
virtual void OnTestStepRunCompleted (TestStepRun stepRun)
 Called when a test step run is completed. Result might still be propagated to the result listener after this event. More...
 
virtual void OnResultPublished (Guid stepRunId, ResultTable result)
 Called when a result is received. More...
 
- Public Member Functions inherited from OpenTap.Resource
 Resource ()
 Instantiate a new instance of Resource class and creates logging source.
 
override string ToString ()
 Overrides ToString() to return the Name of the resource. Can be overridden by derived classes to provider a more descriptive name. Note the overrider should include the Name in the output.
 
virtual void Open ()
 When overridden in a derived class, should contain implementation to open a connection to the resource represented by this class. Any one time initialization should be done here as well.
 
virtual void Close ()
 When overridden in a derived class, should contain implementation to close the connection made to the resource represented by this class.
 
void OnActivity ()
 Triggers the ActivityStateChanged event.
 
- Public Member Functions inherited from OpenTap.ValidatingObject
void OnPropertyChanged (string propertyName)
 Triggers the PropertyChanged event. More...
 

Protected Member Functions

virtual void onEnabledChanged (bool oldValue, bool newValue)
 Called when IsEnabled is changed. More...
 
- Protected Member Functions inherited from OpenTap.ValidatingObject
virtual string GetError (string propertyName=null)
 Return the error for a given property
 
void ThrowOnValidationError (bool ignoreDisabledProperties)
 Checks all validation rules on this object (Rules) and throws an AggregateException on errors. More...
 

Additional Inherited Members

- Properties inherited from OpenTap.Resource
TraceSource Log [get]
 Default log that the resource object can write to. Typically used by instances and extensions of the Resource object.
 
string Name [getset]
 A short name displayed in the user interface where space is limited.
 
bool IsConnected [getset]
 Indicates whether this resource is currently connected. This value should be set by Open() and Close().
 
- Properties inherited from OpenTap.ValidatingObject
ValidationRuleCollection Rules [get]
 All the validation rules. Add new rules to this in order to get runtime value validation.
 
string Error [get]
 Gets the error messages for each invalid rule and joins them with a newline.
 
- Properties inherited from OpenTap.IValidatingObject
ValidationRuleCollection Rules [get]
 A collection of all the currently defined validation rules. Add new rules here in order to get runtime value validation.
 
- Properties inherited from OpenTap.IResource
string Name [getset]
 A short name to display in the user interface in areas with limited space.
 
bool IsConnected [get]
 Indicates whether this DUT is currently connected. This value should be set by Open() and Close().
 
- Properties inherited from OpenTap.IEnabledResource
bool IsEnabled [getset]
 Gets or sets if this resources is enabled.
 
- Events inherited from OpenTap.Resource
EventHandler< EventArgs > Activity
 Invoked on activity.
 
- Events inherited from OpenTap.ValidatingObject
PropertyChangedEventHandler PropertyChanged
 Standard PropertyChanged event object.
 
- Events inherited from OpenTap.INotifyActivity
EventHandler< EventArgs > Activity
 Invoked on activity.
 

Detailed Description

Abstract class forming the basis for all ResultListeners.

Member Function Documentation

◆ onEnabledChanged()

virtual void OpenTap.ResultListener.onEnabledChanged ( bool  oldValue,
bool  newValue 
)
inlineprotectedvirtual

Called when IsEnabled is changed.

Parameters
oldValue
newValue

◆ OnResultPublished()

virtual void OpenTap.ResultListener.OnResultPublished ( Guid  stepRunId,
ResultTable  result 
)
inlinevirtual

Called when a result is received.

Parameters
stepRunIdStep run ID.
resultResult structure.

Implements OpenTap.IResultListener.

◆ OnTestPlanRunCompleted()

virtual void OpenTap.ResultListener.OnTestPlanRunCompleted ( TestPlanRun  planRun,
System.IO.Stream  logStream 
)
inlinevirtual

Called when test plan finishes. At this point no more results will be sent to the result listener from the test plan run.

Parameters
planRunTest plan run parameters.
logStreamThe log file from the test plan run as a stream.

Implements OpenTap.IResultListener.

◆ OnTestPlanRunStart()

virtual void OpenTap.ResultListener.OnTestPlanRunStart ( TestPlanRun  planRun)
inlinevirtual

Called when a test plan starts.

Parameters
planRunTest plan run parameters.

Implements OpenTap.IResultListener.

Reimplemented in OpenTap.TestPlanRunSummaryListener.

◆ OnTestStepRunCompleted()

virtual void OpenTap.ResultListener.OnTestStepRunCompleted ( TestStepRun  stepRun)
inlinevirtual

Called when a test step run is completed. Result might still be propagated to the result listener after this event.

Parameters
stepRunStep run parameters.

Implements OpenTap.IResultListener.

Reimplemented in OpenTap.TestPlanRunSummaryListener.

◆ OnTestStepRunStart()

virtual void OpenTap.ResultListener.OnTestStepRunStart ( TestStepRun  stepRun)
inlinevirtual

Called just before a test step is started.

Parameters
stepRun

Implements OpenTap.IResultListener.

Reimplemented in OpenTap.TestPlanRunSummaryListener.

OpenTAP 9.24 API built Tue Apr 30 2024 13:44:42