FILEMENU

FILEMENU(sFileMenu AS STRING, sWaitedDTMF AS STRING [, nRepeat AS INTEGER [, nTimeout AS INTEGER [, sErrFile AS STRING[, bErrAbort AS BOOLEAN]]]]) AS INTEGER

Plays a voice menu and returns the user's DTMF choice.

The audio file menu is given by <sFileMenu>. The allowed DTMF codes are described by the string <sWaitedDTMF>. If the entered DTMF code is NOT in the waited DTMF list, or if nothing is typed during the <nTimeOut> delay (in seconds), the menu is repeated <nRepeat> times. For each invalid choice or each timeout, the optional error message <sErrFile> will be played (if <bErrAbort> is TRUE, all other playing messages will be stopped).

The returned value depends on the pressed key: 0 to 9 for numerical keys, 10 for A, 11 for B, ..., 16 for #, 17 for *, -2 when timeout expired without key, -1 when line is hung-up, -3 if the second call of a telephony transfer is hung-up.