Note
Access to this page requires authorization. You can try signing in or changing directories.
Access to this page requires authorization. You can try changing directories.
This interface enables applications to manage the words and phrases that the SR engine will recognize. It inherits from ISpGrammarBuilder.
Each object implementing ISpRecoGrammar can have a context-free grammar (CFG) and a dictation grammar loaded simultaneously (for example, using the CFG if possible, but returning to dictation if the CFG fails to parse). A single recognizer object implementing ISpRecognizer can have multiple speech recognition context objects (ISpRecoContext) associated with it. Similarly, a single context object can be associated with multiple objects implementing ISpRecoGrammar. This one-to-many relationship allows applications to separate types of recognizable phrases and content into separate objects for clearer application logic.
Methods
The following table lists methods for the ISpRecoGrammar interface.
| Methods | Description |
|---|---|
| GetGrammarId | Gets the grammar identifier associated with the application. |
| GetGrammarState | Gets recognition grammar state information. |
| GetRecoContext | Gets the context object that created the grammar. |
| IsPronounceable | Determines if a word has a pronunciation. |
| LoadCmdFromFile | Loads a command and control grammar from a file. |
| LoadCmdFromMemory | Loads a command and control grammar from memory. |
| LoadCmdFromProprietaryGrammar | Loads an engine proprietary format command and control grammar. |
| LoadCmdFromResource | Loads a command and control grammar from a Win32 resource. |
| LoadDictation | Loads and initializes a dictation topic. |
| SaveCmd | Allows applications using dynamic grammars to save the current grammar state to a stream. |
| SetDictationState | Sets a dictation state to active or inactive. |
| SetGrammarState | Sets the state of a grammar. Changing the state affects the state of all the active rules in the grammar. |
| SetRuleIdState | Activates or deactivates a rule by its rule identifier. |
| SetRuleState | Activates or deactivates a rule by its rule name. |
| SetTextSelection | Sets the insertion point (using word sequence data buffer). |
| SetWordSequenceData | Sets word sequence data. |
| UnloadDictation | Unloads the active dictation topic from the grammar. |
Requirements
OS Versions: Windows CE .NET 4.1 and later.
Header: Sapi.h, Sapi.idl.
Link Library: Sapilib.lib.
See Also
Send Feedback on this topic to the authors