Record Runtime Properties

AppendFileMode

(Boolean)

This property overrides the append mode set by the AppendFile property on a per-call basis. It allows for an additional option, to append the new message data to the file, as well as overwriting or appending the new data. This property uses the vbvAppendModeConstants:

Filename

(Channel as Integer) String

The filename created is available from the Filename property. Override the filename in VB code by setting the property in the Enterevent. Changing the filename at any other time has no effect. Also use the filename as part of a greeting in order to replay the message. If the message is cancelled or not recorded, the filename property is empty.

EXAMPLES

To access the filename:

mystring = Record1.Filename(channel)

To override the filename:

Record1.Filename(channel) = myfile.tmp

FileSize

(Channel as Integer) Long

This property contains the size (in bytes) of the file recorded by the Record control. If no file has been recorded, the value is 0.

GotoNode

(Integer)

This property transfers a call to another control. See GotoNode.

MaxSil

(Channel as Integer) Integer

This is the duration (in seconds) of silence before VBVoice decides that the caller has stopped talking. This property is set by the control to the value Maximum Silence in the Setup property page. It can be changed in the Enterevent to another value. The new value affects only the current call until it leaves this control.

MaxTime

(Channel as Integer) Integer

This is the maximum duration (in seconds) allowed for the recorded message. This property is set by the control to the value Max time for Record in the Setup property page. It can be changed in the Enterevent to another value if required. The new value affects only the current call until it leaves this control. The maximum time that can be set is 32767 seconds. To record longer files, either disable the maximum time by using a value of 0, or move to another record control with the AppendMode set to True to append more data to the same message.

EXAMPLE

To override the maximum time setting:

If CallerName = "Fred" Then
Record1.MaxTime(channel) = 5 'Stop after 5 seconds of silence.
End If

MsgData

(String)

See Message Data.

OptionDigit

(Channel as Integer) vbvDigitMaskConstants

Use this property to access the last option digit entered by the caller, either after the call has exited the control or in the OptionDigit event.

TermDigitMask

(Channel as Integer) Integer

The digits that terminate a record or options greeting. Normally this property is set by the control from the digit options. This property can be set in the Enter Event to disable certain Record options for different callers. If a call re-enters the control via the second input, the property should be reset in the EnterB event

TermDigitMask is an integer, made up of vbvDigitMaskConstants.

EXAMPLES

Different vbvDigit_values can be ordered together to enable and disable different option digits. This property can be set in the Enter event to assign different options to different callers.

EXAMPLE

To override the digit mask setting:

If CallerName = Fred Then
Record1. TermDigitMask(channel) = vbvDigit_1 OR vbvDigit_5
Endif

Read more about Record control.