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