GetRunner Method (XJLink, XjtagOutputBox, string)
Gets a Runner object for the specified XJLink using the specified pin mapping file, displaying test output in an XjtagOutputBox.
Type: RunnerProject
Namespace: XJTAG.Integration.XJRunner
Syntax
public Runner GetRunner(XJLink xjlink, XjtagOutputBox testOutputBox, string pinMapFile)
Parameters
- xjlink
Type: XJLink
The XJLink to use to run the tests.
- testOutputBox
Type: XjtagOutputBox
The XjtagOutputBox in which to display test output.
- pinMapFile
Type: string
The full path to the pin mapping file to use. If not specified, the project default is used. For XJPack (.xjp) files only pin mappings included as additional files in the XJPack file may be loaded. In this case pinMapFile should be the original pin mapping file path relative to the project file.
Exceptions
- System.InvalidOperationException
The specified XJLink is in use with another Runner instance.
- ProjectException
No suitable licence is available to allow the project to be run.
- RuntimeException
There was an error creating the Runner object.
- System.ObjectDisposedException
The RunnerProject has already been disposed.
Remarks
This overload of GetRunner uses the provided XjtagOutputBox control to display test output as it is generated by the resulting Runner instance. The TextOutputGenerated event and the OutputFromLastTestRun property can still be used as well.
XJTAG v4.2.5