Adds a voice command into the current window. The command is automatically disabled when closing the window. This voice command can be deleted by DeleteVoiceCommand
Remark: a speech recognition program must be installed on the runtime computer. A speech recognition program is supplied with Windows Vista. For the other systems, "Dragon Naturally Speaking" must be installed (tests run with version 9 "Preferred" or "standard").
// Start the "Proc_Anim_Window" procedure if the voice command is recognized
nVoiceID is int
nVoiceID = AddVoiceCommand("Proc_Anim_Window", "Animate the window")
// Start the "Find" procedure if the voice command is recognized
nVoice1ID is int = AddVoiceCommand(Find, "Finds the form of")
nVoice2ID is int = AddVoiceCommand(Find, "Displays the form of")
nVoice3ID is int = AddVoiceCommand(Find, "Searches for the form of")
INTERNAL PROCÉDURE Find(Param1)
sCustomer is string = Param1[[21 TO ]]
HReadSeekFirst(sCustomer, FIRSTNAMELASTNAME, sCustomer)
<Result> = AddVoiceCommand(<WLanguage procedure> , <Sentence to recognize>)
Identifier of the voice command.
<WLanguage procedure>: Procedure name
Name of the procedure that will be run when the voice command is heard. This procedure has the following format:
PROCEDURE <Procedure name> (<Parameter name>)
<Parameter name> is a character string parameter. At runtime, <Parameter name> corresponds to the sentence that is recognized.
<Sentence to recognize>: Character string
Sentence used to trigger the execution of the procedure. If this parameter corresponds to an empty string (""), the specified procedure will be run for each sentence spoken.
If <Sentence to recognize> corresponds to an empty string (""), the procedure will be run for each sentence pronounced. This enables you to process the sentenced spoken in the procedure in order to recognize the voice command that was used.
You can for example store in an array (associative array for example) all the available voice commands (phonetically) and the procedure associated with each one of these commands.
To do so, pass each word of the sentence phonetically and compare the sentence with the array of voice commands. If the command is recognized, the associated procedure can be run.
To improve the understanding, you also have the ability to delete the unnecessary words found at the beginning and at the end of sentence.
AddVoiceCommand must be used in the initialization code of the window or control. This function is not recognized if it is used in the project initialization code.