Engine

Use the Engine class to create and access objects of other classes, control executions, launch built-in dialog boxes, implement a Tools menu, find files and directories, and invoke various utilities. Create the Engine object directly using ActiveX. To access the Engine object from a step, use the TestStand API to obtain the value of the Engine property from the SequenceContext class or pass the SequenceContext property RunState.Engine as an object parameter to the step.

The following examples show how to create the initial Engine object:

LabWindows/CVI

CAObjHandle engineObj = 0; TS_NewEngine(NULL, &engineObj);

Visual Basic

'Place the TestStand Engine ActiveX control on the main form.

Visual C/C++

#import "C:\TestStand\Bin\teapi.dll" TS::IEnginePtr engine; HRESULT hr = engine.CreateInstance(__uuidof(TS::Engine)) ;

Properties

Methods

AbortAll
AcquireLicense
AddImage
BeginProfiling
BreakAll
CallFrontEndCallbackEx
CanCreateStep
CheckExpression
CheckExprSyntax
ClearFilePasswordCache
CommitGlobalsToDisk
CopyPropertyObject
CreateNewUniqueStepIds
CreateTempFile
CurrentUserHasPrivilege
DelocalizeExpression
DisplayAdapterConfigDialog
DisplayBreakpointDialog
DisplayBrowseExprDialogEx
DisplayBrowsePropertyObjectDialog
DisplayConfigureTypePalettesDialog
DisplayEditBreakAndWatchDialog
DisplayEditPathsInFilesDialog
DisplayEditUserDialog
DisplayErrorDialog
DisplayExpressionEditOptionsDialog
DisplayExternalViewerDialog
DisplayFileDialog
DisplayHelpFile
DisplayHelpTopic
DisplayHelpTopicEx
DisplayIOConfigurationOptionsDialog
DisplayLockUnlockDialog
DisplayLoginDialog
DisplayLoopOnStepsDialog
DisplayMessageBox
DisplayNewUserDialog
DisplayOptionsDialog
DisplayPasswordProtectTypeDefinitionsDialog
DisplayPreconditionBuilderDialog
DisplayPreconditionDialog
DisplayRunTimeErrorDialogEx
DisplaySearchDirDialog
DisplaySeqFilePropDialog
DisplaySequenceFileCallbacksDialog
DisplaySequencePropDialog
DisplayStepPropDialog
DisplayStepTypeMenuEditorEx
DisplayToolMenuDialog
DisplayUnlockTypeDefinitionsDialog
DisplayWorkspaceBrowserDialog
DoDotNetGarbageCollection
EndProfiling
ExpandPathMacros
FindFileEx
FindPath
GetAdapter
GetAdapterByKeyName
GetEditTimeToolMenuItems
GetEngineConfigFile
GetEnvironmentPath
GetErrorString
GetFileInformation
GetImageIndex
GetImageName
GetInsertStepMenuStructure
GetInsertVariableMenuStructure
GetInternalOption
GetLicenseDescription
GetLocalizedDecimalPoint
GetLocationForNextDialog
GetModuleProfiling
GetProductRegistrationInfo
GetRelativePathFromAbsolutePath
GetResourceString
GetResourceSymbols
GetRunTimeToolMenuItems
GetSequenceFileEx
GetStationModelSequenceFile
GetSyncManager
GetTemplatesFile
GetTestStandPath
GetTypeDefinition
GetTypeNames
GetTypePaletteFileList
GetTypes
GetTypeUsageLocations
GetUIMessage
GetUser
GetUserGroup
GetWatchExpressions
GetWatchExpressionsChangeCount
HasAddonLicense
IsCurrentSequenceFileVersion
LaunchExternalViewer
LoadTypePaletteFilesEx
LocalizeExpression
LogProfilerAction
NewCsvFileInputRecordStream
NewCsvFileOutputRecordStream
NewDataType
NewEditArgs
NewEditContext
NewEvaluationTypes
NewExecution
NewExpression
NewHierarchicalExecution
NewInteractiveArgs
NewLocations
NewOutputMessage
NewOutputMessages
NewPropertyObject
NewPropertyObjectFile
NewPropertyObjectType
NewResultLog
NewResultLogger
NewSequence
NewSequenceFile
NewStep
NewStepType
NewTypeUsageList
NewUndoItemCreator
NewUndoStack
NewUser
NewWorkspaceFile
NotifyEndOfModalDialog
NotifyStartOfModalDialogEx
OpenWorkspaceFile
ParseLookupString
PostUIMessage
ReadPropertyObjectFile
RegisterModalWindow
RegisterSequenceToExecuteOnCrash
RegisterUIMessage
RegisterUIMessageCallbackEx
ReleaseLicense
ReleaseSequenceFileEx
ReloadGlobals
ReloadStringResourceFiles
ResetTypeInstances
SaveAllModifiedSeqFiles
SearchFiles
SerializeObjects
SetConfigDirectory
SetInternalOption
SetLocationForNextDialog
SetModuleProfiling
SetTypePaletteFileList
ShouldAutoLaunchExternalReportViewer
ShutDown
TerminateAll
UnloadAllModules
UnloadTypePaletteFiles
UnregisterModalWindow
UnregisterSequenceToExecuteOnCrash
UnserializeObjects
UnserializeObjectsAndTypes
UserNameExists
WriteToolMenuToDisk

Event

See Also

SequenceContext.Engine