CTextReader Class Reference

#include <textreader.h>

Link against: textreader.lib

class CTextReader : public CBase, public MTextReaderInput, public MTextReaderController
Public Member Functions
virtual ~CTextReader()
virtual IMPORT_C TIntAppendAudioL(TInt, const RFile &)
virtual IMPORT_C TIntAppendGroupL()
virtual IMPORT_C TIntAppendPauseL(TInt, TTimeIntervalMicroSeconds)
virtual IMPORT_C TIntAppendTextL(TInt, const TDesC &, const TTtsStyle *)
virtual IMPORT_C TIntAppendToneL(TInt, TTimeIntervalMicroSeconds, TInt)
virtual IMPORT_C TTimeIntervalMicroSecondsDuration()
virtual IMPORT_C TBoolForwardL()
IMPORT_C voidGetMessageReaderLanguagesL(RArray< TLanguage > &)
IMPORT_C voidInitializeL()
IMPORT_C TIntInsertGroupL(TInt)
virtual IMPORT_C TIntMaxVolume()
IMPORT_C CTextReader *NewL(MTextReaderControllerObserver &)
IMPORT_C CTextReader *NewLC(MTextReaderControllerObserver &)
virtual IMPORT_C TBoolNextL()
virtual IMPORT_C voidPause()
IMPORT_C voidPlayL(TInt)
virtual IMPORT_C TTimeIntervalMicroSecondsPosition()
virtual IMPORT_C TBoolPreviousL()
virtual IMPORT_C voidRemoveGroupL(TInt)
virtual IMPORT_C voidReplaceItemAudioL(TInt, TInt, const RFile &)
virtual IMPORT_C voidReplaceItemPauseL(TInt, TInt, TTimeIntervalMicroSeconds)
virtual IMPORT_C voidReplaceItemTextL(TInt, TInt, const TDesC &, const TTtsStyle *)
virtual IMPORT_C voidReplaceItemToneL(TInt, TInt, TTimeIntervalMicroSeconds, TInt)
virtual IMPORT_C voidResetGroupL(TInt)
virtual IMPORT_C TBoolRewindL()
virtual IMPORT_C voidSetAudioOutputL(TInt)
virtual IMPORT_C voidSetSpeakingRateL(TInt)
virtual IMPORT_C voidSetVolume(TInt)
virtual IMPORT_C voidStop()
virtual IMPORT_C TIntVolume()
Inherited Functions
CBase::CBase()
CBase::Delete(CBase *)
CBase::Extension_(TUint,TAny *&,TAny *)
CBase::operator new(TUint)
CBase::operator new(TUint,TAny *)
CBase::operator new(TUint,TLeave)
CBase::operator new(TUint,TLeave,TUint)
CBase::operator new(TUint,TUint)
CBase::~CBase()
MTextReaderController::PlayL(TBool)

Detailed Description

Text Reader

Constructor & Destructor Documentation

~CTextReader ( )

IMPORT_C~CTextReader()[virtual]

Member Function Documentation

AppendAudioL ( TInt, const RFile & )

IMPORT_C TIntAppendAudioL(TIntaGroupId,
const RFile &aFile
)[virtual]

Append audio item to group

Parameters
aGroupIdIdentifier for group
aFileFile handle to the audio file
Return Value
Identifier for appended item inside group

AppendGroupL ( )

IMPORT_C TIntAppendGroupL()[virtual]

Append a group to queue

Return Value
Id of a created group

AppendPauseL ( TInt, TTimeIntervalMicroSeconds )

IMPORT_C TIntAppendPauseL(TIntaGroupId,
TTimeIntervalMicroSecondsaDuration =  KDefaultPauseDuration
)[virtual]

Append pause item to group

Parameters
aGroupIdIdentifier for group
Return Value
Identifier for appended item inside group

AppendTextL ( TInt, const TDesC &, const TTtsStyle * )

IMPORT_C TIntAppendTextL(TIntaGroupId,
const TDesC &aText,
const TTtsStyle *aStyle = 0
)[virtual]

Append text item to group

Parameters
aGroupIdIdentifier for group
aTextText to be added (copied)
aStyleSynthesis settings
Return Value
Identifier for appended item inside group

AppendToneL ( TInt, TTimeIntervalMicroSeconds, TInt )

IMPORT_C TIntAppendToneL(TIntaGroupId,
TTimeIntervalMicroSecondsaDuration =  KDefaultToneDuration ,
TIntaFrequency =  KDefaultToneFrequency
)[virtual]

Append tone item to group

Parameters
aGroupIdIdentifier for group
Return Value
Identifier for appended item inside group

Duration ( )

IMPORT_C TTimeIntervalMicroSecondsDuration()[virtual]

From MTextReaderController Give duration

Return Value
Duration in ms

ForwardL ( )

IMPORT_C TBoolForwardL()[virtual]

Forward to next item.

Return Value
ETrue if can be forwarded otherwise EFalse

GetMessageReaderLanguagesL ( RArray< TLanguage > & )

IMPORT_C voidGetMessageReaderLanguagesL(RArray< TLanguage > &aLanguages)

For getting supported TTS languages to be used in MR (Klatt languages are ignored)

InitializeL ( )

IMPORT_C voidInitializeL()

InsertGroupL ( TInt )

IMPORT_C TIntInsertGroupL(TIntaPos)

Insert a group to array

Return Value
Id of a created group

MaxVolume ( )

IMPORT_C TIntMaxVolume()[virtual]

From MTextReaderController Max volume

Return Value
Maximum volume level

NewL ( MTextReaderControllerObserver & )

IMPORT_C CTextReader *NewL(MTextReaderControllerObserver &aObserver)[static]

NewLC ( MTextReaderControllerObserver & )

IMPORT_C CTextReader *NewLC(MTextReaderControllerObserver &aObserver)[static]

NextL ( )

IMPORT_C TBoolNextL()[virtual]

Move to the next group of items.

Return Value
ETrue if can be moved otherwise EFalse

Pause ( )

IMPORT_C voidPause()[virtual]

Pause playing

PlayL ( TInt )

IMPORT_C voidPlayL(TIntaIndex)

Start playback

Position ( )

IMPORT_C TTimeIntervalMicroSecondsPosition()[virtual]

From MTextReaderController Gives position

Return Value
Position in ms

PreviousL ( )

IMPORT_C TBoolPreviousL()[virtual]

Move to the previous group of items.

Return Value
ETrue if can be forwarded otherwise EFalse

RemoveGroupL ( TInt )

IMPORT_C voidRemoveGroupL(TIntaGroupId)[virtual]

Deletes a group from queue

Parameters
aGroupIdId of deleted group

ReplaceItemAudioL ( TInt, TInt, const RFile & )

IMPORT_C voidReplaceItemAudioL(TIntaGroupId,
TIntaItemId,
const RFile &aFile
)[virtual]

Replace existing item with an audio item

Parameters
aGroupIdIdentifier for group
aItemIdIdentifier for item inside a group
aFileFile handle to the audio file

ReplaceItemPauseL ( TInt, TInt, TTimeIntervalMicroSeconds )

IMPORT_C voidReplaceItemPauseL(TIntaGroupId,
TIntaItemId,
TTimeIntervalMicroSecondsaDuration =  KDefaultPauseDuration
)[virtual]

Replace existing item with a pause item

Parameters
aGroupIdIdentifier for group
aItemIdIdentifier for item inside a group
aDurationDuration of pause

ReplaceItemTextL ( TInt, TInt, const TDesC &, const TTtsStyle * )

IMPORT_C voidReplaceItemTextL(TIntaGroupId,
TIntaItemId,
const TDesC &aText,
const TTtsStyle *aStyle = 0
)[virtual]

Replace existing item with a text item

Parameters
aGroupIdIdentifier for group
aItemIdIdentifier for item inside a group
aTextText to be added (copied)
aStyleSynthesis settings, ownership stays in client

ReplaceItemToneL ( TInt, TInt, TTimeIntervalMicroSeconds, TInt )

IMPORT_C voidReplaceItemToneL(TIntaGroupId,
TIntaItemId,
TTimeIntervalMicroSecondsaDuration =  KDefaultToneDuration ,
TIntaFrequency =  KDefaultToneFrequency
)[virtual]

Replace existing item with a tone item

Parameters
aGroupIdIdentifier for group
aItemIdIdentifier for item inside a group
aDurationDuration of tone
aFrequencyFrequency of tone

ResetGroupL ( TInt )

IMPORT_C voidResetGroupL(TIntaGroupId)[virtual]

Resets a group, ie. removes all items it has.

Parameters
aGroupIdId of group to be resetted

RewindL ( )

IMPORT_C TBoolRewindL()[virtual]

Go back to previous item.

Return Value
ETrue if can be rewinded otherwise EFalse

SetAudioOutputL ( TInt )

IMPORT_C voidSetAudioOutputL(TIntaAudioOutput)[virtual]

From MTextReaderController Set audio output

SetSpeakingRateL ( TInt )

IMPORT_C voidSetSpeakingRateL(TIntaValue)[virtual]

From MTextReaderController Set speaking rate

SetVolume ( TInt )

IMPORT_C voidSetVolume(TIntaVolume)[virtual]

From MTextReaderController Set volume

Stop ( )

IMPORT_C voidStop()[virtual]

Stop playing

Volume ( )

IMPORT_C TIntVolume()[virtual]

From MTextReaderController Current volume

Return Value
Current volume level