SrgsRule.Scope Propriété

public:
 property System::Speech::Recognition::SrgsGrammar::SrgsRuleScope Scope { System::Speech::Recognition::SrgsGrammar::SrgsRuleScope get(); void set(System::Speech::Recognition::SrgsGrammar::SrgsRuleScope value); };

public System.Speech.Recognition.SrgsGrammar.SrgsRuleScope Scope { get; set; }

member this.Scope : System.Speech.Recognition.SrgsGrammar.SrgsRuleScope with get, set

Public Property Scope As SrgsRuleScope

Valeur de propriété

Valeur qui définit l’étendue de la règle.

Exemples

L’exemple suivant crée une grammaire qui reconnaît l’expression « Une nation qui a gagné la Coupe du Monde » suivie du nom d’un pays qui a remporté la Coupe du Monde. Il crée une règle publique nommée WorldCupWinner et définit l’étendue de cette règle sur Public.

// Create an SrgsDocument, create a new rule and set its scope to public.
SrgsDocument document = new SrgsDocument();
SrgsRule winnerRule = new SrgsRule("WorldCupWinner");
winnerRule.Scope = SrgsRuleScope.Public;

// Add the introduction.
winnerRule.Elements.Add(new SrgsItem("A nation that has won the world cup is: "));

// Create the rule for the European nations.
SrgsOneOf oneOfEurope = new SrgsOneOf(new SrgsItem[] {new SrgsItem("England"), new SrgsItem("France"), new SrgsItem("Germany"), new SrgsItem("Italy")});
SrgsRule ruleEurope = (new SrgsRule("EuropeanNations", new SrgsElement[] {oneOfEurope}));

// Create the rule for the South American nations.
SrgsOneOf oneOfSAmerica = new SrgsOneOf(new SrgsItem[] {new SrgsItem("Argentina"), new SrgsItem("Brazil"), new SrgsItem("Uruguay")});
SrgsRule ruleSAmerica = (new SrgsRule("SouthAmericanNations", new SrgsElement[] {oneOfSAmerica}));

// Add references to winnerRule for ruleEurope and ruleSAmerica.
winnerRule.Elements.Add(new SrgsOneOf(new SrgsItem[] {(new SrgsItem (new SrgsRuleRef(ruleEurope)), new SrgsItem(new SrgsRuleRef(ruleSAmerica)})));

// Add all the rules to the document and make winnerRule
// the root rule of the document.
document.Rules.Add(new SrgsRule[] {winnerRule, ruleEurope, ruleSAmerica});
document.Root = winnerRule;

La grammaire créée a le formulaire suivant.

<grammar version="1.0" xml:lang="en-US" xmlns="http://www.w3.org/2001/06/grammar" root="WorldCupWinner">
    <rule id="WorldCupWinner" scope="public">
        <item> A nation that has won the world cup is </item>
        <one-of>
            <item>
                <ruleref uri="#EuropeanNations" />
            </item>
            <item>
                <ruleref uri="#SouthAmericanNations" />
            </item>
        </one-of>
    </rule>
    <rule id="EuropeanNations">
        <one-of>
            <item> England< /item>
            <item> France </item>
            <item> Germany </item>
            <item> Italy </item>
        </one-of>
    </rule>
    <rule id="SouthAmericanNations">
        <one-of>
            <item> Argentina </item>
            <item> Brazil </item>
            <item> Uruguay </item>
        </one-of>
    </rule>
</grammar>

Remarques

La valeur par défaut de l’étendue est Private. Une règle privée ne peut être activée que pour la reconnaissance par une référence de règle à partir de la règle racine dans sa grammaire contenante ou d’une autre règle référencée à partir de la règle racine. Une règle privée ne peut pas être référencée par une grammaire externe, sauf si la règle privée est déclarée comme règle racine de sa grammaire contenante.

Si son étendue est définie Publicsur , un SrgsRule objet peut être activé pour la reconnaissance par une référence d’un SrgsRuleRef objet dans la grammaire contenante ou à partir d’une règle dans une grammaire externe.

Voir aussi

• Créer des grammaires à l’aide de SrgsGrammar
• Spécification de grammaire de reconnaissance vocale