Class TBaSystemSoundInfo

class TBaSystemSoundInfo;

Description

Provides functions that contain the information for a system sound. A sound may be a file, a tone or a fixed sequence.

The characteristics of a physical sound that corresponds to a logical sound are encapsulated in a TBaSystemSoundInfo object. You can get and set the physical sound for a logical sound through the functions provided by the BaSystemSound class.

Members

Defined in TBaSystemSoundInfo:
EFile, ENull, ESequence, ETone, FileName(), FixedSequenceNumber(), SetFileName(), SetFixedSequenceNumber(), SetTone(), SoundCategory(), TBaSystemSoundInfo(), TBaSystemSoundInfo(), TBaSystemSoundInfo(), TBaSystemSoundInfo(), TSoundCategory, TTone, Tone(), iPriority, iType, iVolume

IMPORT_C TBaSystemSoundInfo();

Description

Constructs a default TBaSystemSoundInfo object. This object has a null type, default volume, default priority, null name, null fixed sequence, and tone of TTone.

IMPORT_C TBaSystemSoundInfo(const TBaSystemSoundType &aType, const TBaSystemSoundName &aName, TInt aVolume=1,TInt aPriority=0);

Description

Constructs a TBaSystemSoundInfo object with the specified type and file name. The sound has default volume and priority.

Parameters

const TBaSystemSoundType &aType Sound type const TBaSystemSoundName &aName Sound name TInt aVolume Sound volume TInt aPriority Sound priority

IMPORT_C TBaSystemSoundInfo(const TBaSystemSoundType &aType, TInt aFixedSequence, TInt aVolume=1,TInt aPriority=0);

Description

Constructs a TBaSystemSoundInfo object with the specified type and sequence. The sound has default volume and priority.

Parameters

const TBaSystemSoundType &aType Sound type TInt aFixedSequence Sound sequence TInt aVolume Sound volume TInt aPriority Sound priority

IMPORT_C TBaSystemSoundInfo(const TBaSystemSoundType &aType, TTone aTone, TInt aVolume=1,TInt aPriority=0);

Description

Constructs a TBaSystemSoundInfo object with the specified type and tone. The sound has default volume and priority.

Parameters

const TBaSystemSoundType &aType Sound type TTone aTone Sound tone TInt aVolume Sound volume TInt aPriority Sound priority

IMPORT_C TSoundCategory SoundCategory() const;

Description

Gets the sound's category.

Return value

TSoundCategory The system sound's category, or NULL if the sound is not a file, sequence, or tone.

inline TInt FixedSequenceNumber() const;

Description

Gets the current sound's sequence.

Return value

TInt The current sound's sequence.

inline TBaSystemSoundName FileName() const;

Description

Gets the current sound's file.

Return value

TBaSystemSoundName The current sound's file.

inline TTone Tone() const;

Description

Gets the current system sound's tone.

Return value

TTone The current sound's tone.

IMPORT_C void SetFixedSequenceNumber(TInt aNumber);

Description

Replaces the current sound with the specified sequence number.

Parameters

TInt aNumber The sequence number with which to replace the current sound.

IMPORT_C void SetFileName(const TBaSystemSoundName &aFileName);

Description

Replaces the current sound with the specified file.

Parameters

const TBaSystemSoundName &aFileName The file with which to replace the current sound.

IMPORT_C void SetTone(const TTone &aTone);

Description

Replaces the current sound with the specified tone.

Parameters

const TTone &aTone The tone with which to replace the current sound.

class TTone;

Description

Provides functions to define a tone. Once defined, the tone can be encapsulated using the TBaSystemSoundInfo class and subsequently played.

Members

Defined in TBaSystemSoundInfo::TTone:
TTone(), TTone(), iDuration, iFrequency

Construction and destruction

---

TTone()

inline TTone();

Description

Default constructor. Sets up a TTone object with null frequency and duration.

---

TTone()

inline TTone(TInt aFrequency, TTimeIntervalMicroSeconds32 aDuration);

Description

Constructor which sets up a TTone object with specified frequency and duration.

Parameters

TInt aFrequency The tone's frequency. TTimeIntervalMicroSeconds32 aDuration The tone's duration.

Member data

---

iFrequency

TInt iFrequency;

Description

Frequency of the tone.

---

iDuration

TTimeIntervalMicroSeconds32 iDuration;

Description

Duration of the tone.

TSoundCategory

Description

Specifies the category of the system sound.

ENull Specifies no system sound. EFile Specifies a file as the system sound. ESequence Specifies a sequence as the system sound. ETone Specifies a tone as the system sound.

TBaSystemSoundType iType;

Description

TInt iVolume;

Description

TInt iPriority;

Description