RuleRef.cs source code in C# .NET

                        
Code:
                         / Dotnetfx_Vista_SP2 / Dotnetfx_Vista_SP2 / 8.0.50727.4016 / WIN_WINDOWS / lh_tools_devdiv_wpf / Windows / wcp / Speech / Src / Internal / SrgsCompiler / RuleRef.cs / 1 / RuleRef.cs
                        

                        
                            //------------------------------------------------------------------ 
// 
//     Copyright (c) Microsoft Corporation.  All rights reserved.
// 
//----------------------------------------------------------------- 

#region Using directives 
 
using System;
using System.Collections.Generic; 
using System.Runtime.InteropServices;
using System.Speech.Internal.SrgsParser;
using System.Text;
 
#endregion
 
namespace System.Speech.Internal.SrgsCompiler 
{
    internal class RuleRef : ParseElement, IRuleRef 
    {
        //*******************************************************************
        //
        // Constructors 
        //
        //******************************************************************* 
 
        #region Constructors
 
        /// 

        /// Special private constructor for Special Rulerefs
        /// 
        ///  
        /// 
        private RuleRef (SpecialRuleRefType type, Rule rule) 
            : base (rule) 
        {
            _type = type; 
        }

        /// 

        /// Add transition corresponding to Special or Uri. 
        /// 
        ///  
        ///  
        /// 
        ///  
        /// 
        /// 
        internal RuleRef (ParseElementCollection parent, Backend backend, Uri uri, List undefRules, string semanticKey, string initParameters)
            :base (parent._rule) 
        {
            string id = uri.OriginalString; 
 
            Rule ruleRef = null;
            int posPound = id.IndexOf ('#'); 

            // Get the initial state for the RuleRef.
            if (posPound == 0)
            { 
                // Internal RuleRef.  Get InitialState of RuleRef.
                // GetRuleRef() may temporarily create a Rule placeholder for later resolution. 
                ruleRef = GetRuleRef (backend, id.Substring (1), undefRules); 
            }
            else 
            {
                // External RuleRef.  Build URL:GrammarUri#RuleName
                StringBuilder sbExternalRuleUri = new StringBuilder ("URL:");
 
                // Add the parameters to initialize a rule
                if (!string.IsNullOrEmpty (initParameters)) 
                { 
                    // look for the # and insert the parameters
                    sbExternalRuleUri.Append (posPound > 0 ? id.Substring (0, posPound) : id); 
                    sbExternalRuleUri.Append ('>');
                    sbExternalRuleUri.Append (initParameters);
                    if (posPound > 0)
                    { 
                        sbExternalRuleUri.Append (id.Substring (posPound));
                    } 
                } 
                else
                { 
                    sbExternalRuleUri.Append (id);
                }

                // Get InitialState of external RuleRef. 
                string sExternalRuleUri = sbExternalRuleUri.ToString ();
                ruleRef = backend.FindRule (sExternalRuleUri); 
                if (ruleRef == null) 
                {
                    ruleRef = backend.CreateRule (sExternalRuleUri, SPCFGRULEATTRIBUTES.SPRAF_Import); 
                }
            }
            Arc rulerefArc = backend.RuleTransition (ruleRef, _rule, 1.0f);
 
            if (!string.IsNullOrEmpty (semanticKey))
            { 
                CfgGrammar.CfgProperty propertyInfo = new CfgGrammar.CfgProperty (); 
                propertyInfo._pszName = "SemanticKey";
                propertyInfo._comValue = semanticKey; 
                propertyInfo._comType = VarEnum.VT_EMPTY;
                backend.AddPropertyTag (rulerefArc, rulerefArc, propertyInfo);
            }
            parent.AddArc (rulerefArc); 
        }
 
        #endregion 

        //******************************************************************** 
        //
        // Internal Method
        //
        //******************************************************************* 

        #region Internal Method 
 
        /// 

        /// Returns the initial state of a special rule. 
        /// For each type of special rule we make a rule with a numeric id and return a reference to it.
        /// 
        /// 
        ///  
        /// 
        internal void InitSpecialRuleRef (Backend backend, ParseElementCollection parent) 
        { 
            Rule rule = null;
 
            // Create a transition corresponding to Special or Uri
            switch (_type)
            {
                case SpecialRuleRefType.Null: 
                    parent.AddArc (backend.EpsilonTransition (1.0f));
                    break; 
 
                case SpecialRuleRefType.Void:
                    rule = backend.FindRule (szSpecialVoid); 
                    if (rule == null)
                    {
                        rule = backend.CreateRule (szSpecialVoid, 0);
                        // Rule with no transitions is a void rule. 
                        ((IRule) rule).PostParse (parent);
                    } 
                    parent.AddArc (backend.RuleTransition (rule, parent._rule, 1.0f)); 
                    break;
 
                case SpecialRuleRefType.Garbage:
                    // Garbage transition is optional whereas Wildcard is not.  So we need additional epsilon transition.
                    OneOf oneOf = new OneOf (parent._rule, backend);
                    // Add the garbage transition 
                    oneOf.AddArc (backend.RuleTransition (CfgGrammar.SPRULETRANS_WILDCARD, parent._rule, 0.5f));
                    // Add a parallele epsilon path 
                    oneOf.AddArc (backend.EpsilonTransition (0.5f)); 
                    ((IOneOf) oneOf).PostParse (parent);
                    break; 

                default:
                    System.Diagnostics.Debug.Assert (false, "Unknown special ruleref type");
                    break; 
            }
        } 
 
        #endregion
 
        //********************************************************************
        //
        // Private Methods
        // 
        //********************************************************************
 
        #region Private Methods 

        /// 
 
        /// Return the initial state of the rule with the specified name.
        /// If the rule is not defined yet, create a placeholder Rule.
        /// 
        ///  
        /// Rule name
        ///  
        ///  
        private static Rule GetRuleRef (Backend backend, string sRuleId, List undefRules)
        { 
            System.Diagnostics.Debug.Assert (!string.IsNullOrEmpty (sRuleId));

            // Get specified rule.
            Rule rule = backend.FindRule (sRuleId); 

            if (rule == null) 
            { 
                // Rule doesn't exist.  Create a placeholder rule and add StateHandle to UndefinedRules.
                rule = backend.CreateRule (sRuleId, 0); 
                undefRules.Insert (0, rule);
            }

            return rule; 
        }
 
        #endregion 

        //******************************************************************* 
        //
        // Public Properties
        //
        //******************************************************************** 

        #region internal Properties 
 
        static internal IRuleRef Null
        { 
            get
            {
                return new RuleRef (SpecialRuleRefType.Null, null);
            } 
        }
 
        static internal IRuleRef Void 
        {
            get 
            {
                return new RuleRef (SpecialRuleRefType.Void, null);
            }
        } 
        static internal IRuleRef Garbage
        { 
            get 
            {
                return new RuleRef (SpecialRuleRefType.Garbage, null); 
            }
        }

        #endregion 

        //******************************************************************* 
        // 
        // Private Fields
        // 
        //*******************************************************************

        #region Private Fields
 
        //*******************************************************************
        // 
        // Private Enums 
        //
        //******************************************************************** 

        #region Private Enums

        /// TODOC <_include file='doc\SpecialRuleRef.uex' path='docs/doc[@for="SpecialRuleRefType"]/*' /> 
        // Special rule references allow grammars based on CFGs to have powerful
        // additional features, such as transitions into dictation (both recognized 
        // or not recognized) and word seqeuences from SAPI 5.0. 
        private enum SpecialRuleRefType
        { 
            /// TODOC <_include file='doc\SpecialRuleRef.uex' path='docs/doc[@for="SpecialRuleRefType.Null"]/*' />
            // Defines a rule that is automatically matched that is, matched without
            // the user speaking any word.
            Null, 
            /// TODOC <_include file='doc\SpecialRuleRef.uex' path='docs/doc[@for="SpecialRuleRefType.Void"]/*' />
            // Defines a rule that can never be spoken. Inserting VOID into a sequence 
            // automatically makes that sequence unspeakable. 
            Void,
            /// TODOC <_include file='doc\SpecialRuleRef.uex' path='docs/doc[@for="SpecialRuleRefType.Garbage"]/*' /> 
            // Defines a rule that may match any speech up until the next rule match,
            // the next token or until the end of spoken input.
            // Designed for applications that would like to recognize some phrases
            // without failing due to irrelevant, or ignorable words. 
            Garbage,
        } 
 
        #endregion
 
        private SpecialRuleRefType _type;

        const string szSpecialVoid = "VOID";
 
        #endregion
    } 
} 

// File provided for Reference Use Only by Microsoft Corporation (c) 2007.
//------------------------------------------------------------------ 
// 
//     Copyright (c) Microsoft Corporation.  All rights reserved.
// 
//----------------------------------------------------------------- 

#region Using directives 
 
using System;
using System.Collections.Generic; 
using System.Runtime.InteropServices;
using System.Speech.Internal.SrgsParser;
using System.Text;
 
#endregion
 
namespace System.Speech.Internal.SrgsCompiler 
{
    internal class RuleRef : ParseElement, IRuleRef 
    {
        //*******************************************************************
        //
        // Constructors 
        //
        //******************************************************************* 
 
        #region Constructors
 
        /// 

        /// Special private constructor for Special Rulerefs
        /// 
        ///  
        /// 
        private RuleRef (SpecialRuleRefType type, Rule rule) 
            : base (rule) 
        {
            _type = type; 
        }

        /// 

        /// Add transition corresponding to Special or Uri. 
        /// 
        ///  
        ///  
        /// 
        ///  
        /// 
        /// 
        internal RuleRef (ParseElementCollection parent, Backend backend, Uri uri, List undefRules, string semanticKey, string initParameters)
            :base (parent._rule) 
        {
            string id = uri.OriginalString; 
 
            Rule ruleRef = null;
            int posPound = id.IndexOf ('#'); 

            // Get the initial state for the RuleRef.
            if (posPound == 0)
            { 
                // Internal RuleRef.  Get InitialState of RuleRef.
                // GetRuleRef() may temporarily create a Rule placeholder for later resolution. 
                ruleRef = GetRuleRef (backend, id.Substring (1), undefRules); 
            }
            else 
            {
                // External RuleRef.  Build URL:GrammarUri#RuleName
                StringBuilder sbExternalRuleUri = new StringBuilder ("URL:");
 
                // Add the parameters to initialize a rule
                if (!string.IsNullOrEmpty (initParameters)) 
                { 
                    // look for the # and insert the parameters
                    sbExternalRuleUri.Append (posPound > 0 ? id.Substring (0, posPound) : id); 
                    sbExternalRuleUri.Append ('>');
                    sbExternalRuleUri.Append (initParameters);
                    if (posPound > 0)
                    { 
                        sbExternalRuleUri.Append (id.Substring (posPound));
                    } 
                } 
                else
                { 
                    sbExternalRuleUri.Append (id);
                }

                // Get InitialState of external RuleRef. 
                string sExternalRuleUri = sbExternalRuleUri.ToString ();
                ruleRef = backend.FindRule (sExternalRuleUri); 
                if (ruleRef == null) 
                {
                    ruleRef = backend.CreateRule (sExternalRuleUri, SPCFGRULEATTRIBUTES.SPRAF_Import); 
                }
            }
            Arc rulerefArc = backend.RuleTransition (ruleRef, _rule, 1.0f);
 
            if (!string.IsNullOrEmpty (semanticKey))
            { 
                CfgGrammar.CfgProperty propertyInfo = new CfgGrammar.CfgProperty (); 
                propertyInfo._pszName = "SemanticKey";
                propertyInfo._comValue = semanticKey; 
                propertyInfo._comType = VarEnum.VT_EMPTY;
                backend.AddPropertyTag (rulerefArc, rulerefArc, propertyInfo);
            }
            parent.AddArc (rulerefArc); 
        }
 
        #endregion 

        //******************************************************************** 
        //
        // Internal Method
        //
        //******************************************************************* 

        #region Internal Method 
 
        /// 

        /// Returns the initial state of a special rule. 
        /// For each type of special rule we make a rule with a numeric id and return a reference to it.
        /// 
        /// 
        ///  
        /// 
        internal void InitSpecialRuleRef (Backend backend, ParseElementCollection parent) 
        { 
            Rule rule = null;
 
            // Create a transition corresponding to Special or Uri
            switch (_type)
            {
                case SpecialRuleRefType.Null: 
                    parent.AddArc (backend.EpsilonTransition (1.0f));
                    break; 
 
                case SpecialRuleRefType.Void:
                    rule = backend.FindRule (szSpecialVoid); 
                    if (rule == null)
                    {
                        rule = backend.CreateRule (szSpecialVoid, 0);
                        // Rule with no transitions is a void rule. 
                        ((IRule) rule).PostParse (parent);
                    } 
                    parent.AddArc (backend.RuleTransition (rule, parent._rule, 1.0f)); 
                    break;
 
                case SpecialRuleRefType.Garbage:
                    // Garbage transition is optional whereas Wildcard is not.  So we need additional epsilon transition.
                    OneOf oneOf = new OneOf (parent._rule, backend);
                    // Add the garbage transition 
                    oneOf.AddArc (backend.RuleTransition (CfgGrammar.SPRULETRANS_WILDCARD, parent._rule, 0.5f));
                    // Add a parallele epsilon path 
                    oneOf.AddArc (backend.EpsilonTransition (0.5f)); 
                    ((IOneOf) oneOf).PostParse (parent);
                    break; 

                default:
                    System.Diagnostics.Debug.Assert (false, "Unknown special ruleref type");
                    break; 
            }
        } 
 
        #endregion
 
        //********************************************************************
        //
        // Private Methods
        // 
        //********************************************************************
 
        #region Private Methods 

        /// 
 
        /// Return the initial state of the rule with the specified name.
        /// If the rule is not defined yet, create a placeholder Rule.
        /// 
        ///  
        /// Rule name
        ///  
        ///  
        private static Rule GetRuleRef (Backend backend, string sRuleId, List undefRules)
        { 
            System.Diagnostics.Debug.Assert (!string.IsNullOrEmpty (sRuleId));

            // Get specified rule.
            Rule rule = backend.FindRule (sRuleId); 

            if (rule == null) 
            { 
                // Rule doesn't exist.  Create a placeholder rule and add StateHandle to UndefinedRules.
                rule = backend.CreateRule (sRuleId, 0); 
                undefRules.Insert (0, rule);
            }

            return rule; 
        }
 
        #endregion 

        //******************************************************************* 
        //
        // Public Properties
        //
        //******************************************************************** 

        #region internal Properties 
 
        static internal IRuleRef Null
        { 
            get
            {
                return new RuleRef (SpecialRuleRefType.Null, null);
            } 
        }
 
        static internal IRuleRef Void 
        {
            get 
            {
                return new RuleRef (SpecialRuleRefType.Void, null);
            }
        } 
        static internal IRuleRef Garbage
        { 
            get 
            {
                return new RuleRef (SpecialRuleRefType.Garbage, null); 
            }
        }

        #endregion 

        //******************************************************************* 
        // 
        // Private Fields
        // 
        //*******************************************************************

        #region Private Fields
 
        //*******************************************************************
        // 
        // Private Enums 
        //
        //******************************************************************** 

        #region Private Enums

        /// TODOC <_include file='doc\SpecialRuleRef.uex' path='docs/doc[@for="SpecialRuleRefType"]/*' /> 
        // Special rule references allow grammars based on CFGs to have powerful
        // additional features, such as transitions into dictation (both recognized 
        // or not recognized) and word seqeuences from SAPI 5.0. 
        private enum SpecialRuleRefType
        { 
            /// TODOC <_include file='doc\SpecialRuleRef.uex' path='docs/doc[@for="SpecialRuleRefType.Null"]/*' />
            // Defines a rule that is automatically matched that is, matched without
            // the user speaking any word.
            Null, 
            /// TODOC <_include file='doc\SpecialRuleRef.uex' path='docs/doc[@for="SpecialRuleRefType.Void"]/*' />
            // Defines a rule that can never be spoken. Inserting VOID into a sequence 
            // automatically makes that sequence unspeakable. 
            Void,
            /// TODOC <_include file='doc\SpecialRuleRef.uex' path='docs/doc[@for="SpecialRuleRefType.Garbage"]/*' /> 
            // Defines a rule that may match any speech up until the next rule match,
            // the next token or until the end of spoken input.
            // Designed for applications that would like to recognize some phrases
            // without failing due to irrelevant, or ignorable words. 
            Garbage,
        } 
 
        #endregion
 
        private SpecialRuleRefType _type;

        const string szSpecialVoid = "VOID";
 
        #endregion
    } 
} 

// File provided for Reference Use Only by Microsoft Corporation (c) 2007.

                        

                        

                        
                        

Link Menu

This book is available now!
Buy at Amazon US or
Buy at Amazon UK

• SqlDataSourceSelectingEventArgs.cs
• VerticalAlignConverter.cs
• DataIdProcessor.cs
• InternalConfigEventArgs.cs
• SchemaImporter.cs
• PermissionSetTriple.cs
• SQLGuid.cs
• MulticastDelegate.cs
• DocumentApplication.cs
• DescendantBaseQuery.cs
• SQLDecimalStorage.cs
• SQLSingleStorage.cs
• CharAnimationBase.cs
• CompiledQuery.cs
• InputLangChangeRequestEvent.cs
• CodeNamespace.cs
• ContextMenuAutomationPeer.cs
• BitmapSizeOptions.cs
• WebServiceBindingAttribute.cs
• Model3D.cs
• ConfigurationManagerInternalFactory.cs
• RedistVersionInfo.cs
• HttpRequest.cs
• ThemeConfigurationDialog.cs
• UniqueEventHelper.cs
• ChannelBinding.cs
• TransformedBitmap.cs
• GPStream.cs
• GcSettings.cs
• IndexedGlyphRun.cs
• FigureParagraph.cs
• ResXResourceReader.cs
• ActivityTypeResolver.xaml.cs
• HitTestResult.cs
• IncrementalHitTester.cs
• ShapingEngine.cs
• MarkupCompilePass1.cs
• FamilyTypefaceCollection.cs
• ResponseStream.cs
• SqlMethods.cs
• MailBnfHelper.cs
• MsmqVerifier.cs
• ZoomPercentageConverter.cs
• SQlBooleanStorage.cs
• MenuItemStyleCollection.cs
• InputLanguage.cs
• BindToObject.cs
• OleDbConnectionInternal.cs
• Pen.cs
• ConditionedDesigner.cs
• SerTrace.cs
• TemplateField.cs
• Int64.cs
• HttpCapabilitiesSectionHandler.cs
• URLIdentityPermission.cs
• ExpressionParser.cs
• WebPartCatalogAddVerb.cs
• ListSortDescriptionCollection.cs
• DateTimeEditor.cs
• DataGridViewSelectedRowCollection.cs
• ConfigurationFileMap.cs
• ImageAnimator.cs
• StringUtil.cs
• Bits.cs
• ApplicationSecurityInfo.cs
• DynamicObjectAccessor.cs
• SR.cs
• NestPullup.cs
• IERequestCache.cs
• SecurityPolicySection.cs
• WebBrowserContainer.cs
• ProviderSettings.cs
• HostProtectionException.cs
• XmlCharacterData.cs
• EntityDataSourceDesignerHelper.cs
• ControlDesignerState.cs
• Marshal.cs
• ContentElement.cs
• TextBoxLine.cs
• DoubleAnimationUsingKeyFrames.cs
• GenericWebPart.cs
• InvalidAsynchronousStateException.cs
• translator.cs
• CreateUserErrorEventArgs.cs
• CacheMemory.cs
• SendActivityDesigner.cs
• ProviderConnectionPointCollection.cs
• RegexCaptureCollection.cs
• InitializationEventAttribute.cs
• SmiRecordBuffer.cs
• KeyNotFoundException.cs
• ApplicationDirectory.cs
• FunctionParameter.cs
• PeerApplicationLaunchInfo.cs
• SourceFileBuildProvider.cs
• StrokeFIndices.cs
• QuaternionIndependentAnimationStorage.cs
• ReverseInheritProperty.cs
• WebHttpElement.cs
• VSWCFServiceContractGenerator.cs