MDiagPluginExecPlan Class Reference

class MDiagPluginExecPlan

Diagnostics Plugin Execution Plan

This class provides interface to access execution plan. It also provides interface to modify execution plan. A cursor to currently executing item is also maintained.

Member Functions Documentation

Count()

TInt Count ( ) const [pure virtual]

Returns total number of items in the plan. Note that this count includes both suite plug-in and test plug-in.

If only interested only test plug-ins. use TestCount() .

CurrentExecutionItem()

const MDiagExecPlanEntry & CurrentExecutionItem ( ) const [pure virtual]

Get current execution plan item.

CurrentIndex()

TInt CurrentIndex ( ) const [pure virtual]

Returns index of execution cursor. Note that this index includes both suite plug-in and test plug-in.

If only interested about test plug-ins. use CurrentTestIndex() .

CurrentTestIndex(TBool)

TInt CurrentTestIndex ( TBool aIncludeDependency ) const [pure virtual]

Get current test index.

Note that only test plug-ins ( MDiagTestPlugin ) are counted in this case. Suite pre/post execution are not. You cannot use this value with [] operator since this is not a real index.

To get real cursor index, use GetCurrentIndex().

Parameters

TBool aIncludeDependency If ETrue, test index will also include plugins that are included as dependency.

IsLastPlugin()

TBool IsLastPlugin ( ) const [pure virtual]

Check if this is the last plug-in being executed.

Note that this includes both test plug-ins and suite plug-ins. If you are interested in checking the progress on tests only, IsLastTest()

IsLastTest()

TBool IsLastTest ( ) const [pure virtual]

Check if this is the last test being executed.

Note that only test plug-ins ( MDiagTestPlugin ) are counted in this case. Suite pre/post execution are not. If you are interested in checking if it is currently running the last plug-in, including test and suites, IsLastPlugin()

ResumeIndex()

TInt ResumeIndex ( ) const [pure virtual]

Returns the plug-in index that plan is resuming from. If this session is not a resume session, this will return 0 (first index). Otherwise, this index will point the first real execution item.

Note that this value will not change as test session progresses. Even as test progresses, this value will still point to the index that this session is being resumed from.

TestCount(TBool)

TInt TestCount ( TBool aIncludeDependency ) const [pure virtual]

Get total test count.

Note that only test plug-ins ( MDiagTestPlugin ) are counted in this case. Suite pre/post execution are not. You cannot use this value with [] operator since this is not a real count.

To get the real number of items in the plan, use GetCount().

Parameters

TBool aIncludeDependency If ETrue, test index will also include plug-ins that are included as dependency.

operator[](TInt)

const MDiagExecPlanEntry & operator[] ( TInt aIndex ) const [pure virtual]

Access an item in plan.

Parameters

TInt aIndex - index