TiScope.TransferringActive

TiScope

Gets whether the Scope is currently transferring data internally from one data block to another or is currently transferring data to the Screen DC for Display.

property TransferringActive : Boolean

Description

Use TransferringActiveto get whether the Scope is currently transferring data internally from one data block to another or is currently transferring data to the Screen DC for Display.

Plain English Explanation: always check this property before adding data or before calling DataBlockBegin and DataBlockEnd. If it is TRUE, then don't add data at this time. If it is FALSE, then it is safe to add data to the scope.

Detailed Explanation: it is necessary to check this property in situations where you are using multiple threads, if you have events that are generated by hardware-based interrupts such as events from your hardware controls, or if you have recursive code. It is good practice to make sure you only have one block of code adding data to the chart at any one time. If you do not check this property, then it is possible that data will be added out of order in the scope or that data will be overwritten, resulting in inaccurate displays or "jumpy" displays.

Example

Delphi

ChartBusy := iComponent.TransferringActive;

if ChartBusy then Exit; //Exit Routine, try again later

iComponent.DataBlockBegin;

//Add your Data Here

iComponent.DataBlockEnd;

C++ Builder

ChartBusy = iComponent->TransferringActive;

if ChartBusy then Exit; //Exit Routine, try again later

iComponent->DataBlockBegin();

//Add your Data Here

iComponent->DataBlockEnd();

Note: this property is Read-Only.

Contents | Index | Previous | Next