<dtmf>

A <dtmf> element specifies a touch-tone key grammar.

Syntax

<dtmf caching="cachingtype"
    fetchhint="fetchtype"
    fetchtimeout="secondsormilliseconds"    
    scope="scopetype"
    src="uri"
    type="mimetype"/>

Attributes

caching

Defines the caching type. If not specified, a value derived from the innermost caching property is used.

Media Encoding Type	Description
fast	Force a query to fetch the most recent copy of the content.
safe	Use the cached copy of the content if it has not expired.

fetchhint

Defines when the interpreter context should retrieve content from the server. If not specified, a value derived from the innermost relevant fetchhint property is used. The default value is the grammarfetchhint property.

Fetch Type	Description
prefetch	Indicates a file may be downloaded when the page is loaded.
safe	Indicates a file that should only be downloaded when actually needed.

fetchtimeout

The interval to wait for the content to be returned before throwing an error.badfetch event. The value is a Time Designation. The default value is the fetchtimeout property.

scope

Either document, which makes the grammar active in all dialogs of the current document (and relevant application leaf documents), or dialog, to make the grammar active throughout the current form. If omitted, the grammar scoping is resolved by looking at the parent element.

Scope Type	Description
dialog	The form grammars are active only in the form.
document	The form grammars are active during any dialog in the same document.

src

The URI specifying the location of the grammar, if it is external.

type

The MIME type of the grammar. If this is omitted, the interpreter context will attempt to determine the type dynamically.

Children

none

Parents

<choice>, <field>, <form>, <link>, <record>, <transfer>.

Variables

none

Example

The following example illustrates using example elements.

<dtmf> 2 </dtmf>

Version Information

Supported in: VoiceXML 1.0.