IVTxtAttributes::TTSModeSet

This method sets the globally unique identifier (GUID) of the current text-to-speech (TTS) mode for a voice text site.

Syntax

HRESULT TTSModeSet( GUID gVoice);

Parameters

gVoice

[in] GUID of the TTS mode to set for the site. If the mode does not exist, an error is returned and the mode is not changed.

Return Values

NOERROR

The method successfully set the GUID of the current TTS mode for a voice text site.

VTXTERR_INVALIDMODE

The text-to-speech mode is invalid, or the application has not been registered to use the voice text on the site.

VTXTERR_INVALIDPARAM

A parameter is invalid.

VTXTERR_OUTOFMEM

There is not enough memory.

Remarks

The text-to-speech mode for a site is saved between uses of the site, even if the user shuts down the computer in the meantime.

If a voice-navigation application is installed on the user’s computer, an application may not need to set the mode.

There is usually only one TTS mode.

See Also

IVTxtAttributes::TTSModeGet