Notify Framework about processing of next item in experiment.

Namespace: ExpSuite
Assembly: FrameWork (in FrameWork.exe) Version: 1.0.0.0

Syntax

Visual Basic
Friend Function NextItem ( _
	lNrInterleaved As Integer, _
	sProgress As Single _
) As Boolean

Parameters

lNrInterleaved
Type: System..::..Int32
Number of interleaved items in experiment.
sProgress
Type: System..::..Single
Optional value of the progress bar in percent [0...100]. The progress bars (in experiment and main screens) will be set only if the progress bar is not synced to the break.

Return Value

TRUE if the last item of the experiment hase been processed. FALSE if there are any items left.

Remarks

NextItem returns the next item index within the interleaved range and provides all functionality which depends on increasing item as breaks, beeps, logging. NextItem returns TRUE if the end of experiment was reached and FALSE otherwise. NextItem will process following tasks:
  • Handle beeps
  • Update labels
  • Induce a break, if necessary. In this case NextItem will terminate after the break is done (or Cancel ocurs).
  • See Also