number_speaker object
This method allows you to specify an existing sound object to be used for any auditory feedback in the number speaker.
bool set_sound_object(sound@ handle)
Parameters:
handle
A handle to an existing sound object that is to be used for all subsequent sound output.
Return value:
true on success, false on failure.
Remarks:
The object that you specify in this function will be used for all subsequent auditory feedback provided to the user in the number speaker. If you do not call this method and still use sound output, an internal sound object will be used instead.
Example:

    // Speak a number with redirected sound playback.

    #include "number_speaker.bgt"

    void main()
    {
    sound my_sound;
    number_speaker number;
    number.set_sound_object(my_sound);
    number.speak_wait(500);
    }