TApxComPort.OnTriggerData

TApxComPort

property OnTriggerData : TTriggerDataEvent
TTriggerDataEvent = procedure(
  CP : TObject; TriggerHandle : Word) of object;

Defines an event handler that is called whenever a string matching a predefined goal is detected in the input buffer.

The event is generated as a result of adding a match string using AddDataTrigger. When the dispatcher finds a matching string in the input buffer, it generates an OnTriggerAvail event for the bytes leading up to the match, then generates an OnTriggerData event for the match. Finally, it generates another OnTriggerAvail event for the matched data itself.

CP is the TApxComPort component that generated the trigger. TriggerHandle is the handle number returned when the trigger was added.

Note that data match triggers remain active until explicitly removed. The event handler can call RemoveTrigger, passing TriggerHandle as the parameter, to remove the trigger that just generated the event.

See also: AddDataTrigger, OnTrigger, OnTriggerAvail