GetDigits Runtime Properties

Digits

(Channel as Integer) String

This property contains the digits collected by the control. This is the default property.

Use it to override the result of the GetDigits control. If you have two paths that both collect the same number, such as a mailbox number, and provide a method of direct input, or a method using database lookup. Subsequent code must reference one control only for the result, so you can use the exit event in say the data�base lookup path to set the Digits as if the caller had entered the digits directly through than by database lookup. This method is used in the Voicemail example program, in the Directory form.

EXAMPLES

To access the result:

mystring = GetDigits1.Digits(channel)
Dim strResult as String
strResult = GetDigits1.Digits(e.channel)

To override the result:

GetDigits1.Digits(channel) = this is the result I really wanted (e.g. 5551234)

GotoNode

(Integer)

This property will transfer a call to another control. See GotoNode.

MaxKeys

(Channel as Integer) Integer

The maximum number of keys to receive before checking the buffer for a valid digit sequence. This value is set by the control to the default Max Keys set in the Terminations property page. It can be changed in the Enter Event to another value if required. The new value only affects the current call until it leaves this control.

MaxSil

(Channel as Integer) Integer

This is the maximum duration of silence (in seconds) while waiting for digits before issuing a time-out. This property is set by the control to the value of Maximum Silence in the Terminations property page. It can be changed in the Enter event to another value if required. The new value only affects the current call until it leaves this control. A value of 0 means that the control does not wait for digits after the greeting has finished playing, but checks the buffer immediately.

EXAMPLE

To override the maximum silence setting:

If CallerName = Fred Then
GetDigits1.MaxSil(channel) = 5
Endif

TermDtmf

(Channel as Integer)

This is a bit-mapped array indicating the keys that terminates the digit collection. This property is calculated at startup based on the digit conditions in the control. It can be changed in the Enter Event to another value if required. The new value only affects the current call until it leaves this control. Use the predefined vbvDigitMaskConstants vbvDigit_0, vbvDigit_1, and so on.

EXAMPLE

To override the TermDtmf property:

GetDigits1.TermDtmf(channel) = vbvDigit_0 OR vbvDigit_S
terminate on 0 and * only

Read more about GetDigits control.