ThbTapiCall.MonitorDigits
Unit: hbTapi

This property enables and disables the unbuffered detection of digits received on the call. Each time a digit of the specified digit mode is detected, the ThbTapiLine.OnDigit event is triggered indicating which digit has been detected.

Availability

Design-Time: None / Run-Time: Read, Write

Declaration

property MonitorDigits: ThbTapiCallMonitorDigits;

See Also

ThbTapiLine.CallOptions.MonitorDigits, ThbTapiLine.OnDigit, ThbTapiCall.GatherDigits


Active (Boolean)

Set this property to True to begin the monitoring for digts. The monitoring is typically useable when the call is in the connected state (the OnConnected event has fired). The OnDigit event fires each time a digit is detected. Set this property to False to stop monitoring for digits. There is no need to set this property to false at the end of a call.

Remarks

In TAPI, the lineMonitorDigits function is called. This functions works in an asynchronous manner. See the SyncMode property to read more about the handling of asynchronous functions.

Errors

Using this function may cause an EhbTapiError exception . Possible errors are:

LINEERR_INVALCALLHANDLE, LINEERR_OPERATIONUNAVAIL, LINEERR_INVALCALLSTATE, LINEERR_OPERATIONFAILED, LINEERR_INVALDIGITMODE, LINEERR_RESOURCEUNAVAIL, LINEERR_NOMEM, LINEERR_UNINITIALIZED.

DigitModes (DWord)

Set this property to the digit mode or modes that are to be monitored. This parameter uses one or more of the LINEDIGITMODE_ Constants and is initialized with the value of ThbTapiLine.CallOptions.MonitorDigits.DigitModes.

Constant

Meaning

LINEDIGITMODE_PULSE

Use this mode to detect rotary pulse sequences to signal digits. Valid digits are 0 through 9.

LINEDIGITMODE_DTMF

Use this mode to detect DTMF tones. Valid digits are 0 through 9, '*', '#', 'A', 'B', 'C', and 'D'.

LINEDIGITMODE_DTMFEND

Use this mode to detect DTMF tones and detect the down edges. Valid digits are 0 through 9, '*', '#', 'A', 'B', 'C', and 'D'.