ISpeechGrammarRuleStateTransition Weight Property (SAPI 5.3)

Microsoft Speech API 5.3

Interface: ISpeechGrammarRuleStateTransition

Weight Property

The Weight property assigns the transition a weight relative to its sibling transitions.


Set: (This property is read-only)
Get: Variant = ISpeechGrammarRuleStateTransition.Weight


  • ISpeechGrammarRuleStateTransition
    The owning object.
  • Variant
    Set: (This property is read-only)
    Get: A Variant variable that gets the property.


Recognition proceeds by means of transitions from one rule state to another. Each rule state has a collection of transitions, which represent the possible recognition paths to subsequent rule states.

In the absence of weighting, each transition is considered equally probable. For example, in a rule state with five transitions, each has a 20 percent probability of being followed. The Weight property enables grammar designers to specify a transition as more probable, or less probable, than its sibling transitions.

The weight property for a transition is a fractional number with a range of zero to one, and the sum of the weights of a rule state's transition should be one.