Click here to Skip to main content
Click here to Skip to main content
Articles » Languages » C# » General » Downloads
 
Add your own
alternative version
Go to top

A .NET State Machine Toolkit - Part III

, 26 Oct 2006
Using code generation with the .NET state machine toolkit.
statemachinetoolkitpartiii_demo.zip
StateMachineToolkit
StateMachineBuilderDemo
App.ico
StateMachineBuilderDemo.csproj.user
StateMachineDemo
App.ico
StateMachineDemo.csproj.user
StateMachineMaker
App.ico
StateMachineMaker.csproj.user
StateMachineToolkit
bin
Debug
LSCollections.dll
CodeGeneration
StateMachineBuilder
StateMachineToolkit.csproj.user
statemachinetoolkitpartiii_src.zip
StateMachineToolkitPartIII_src
CodeGeneration
/*
 * Created by: Leslie Sanford
 * 
 * Contact: jabberdabber@hotmail.com
 * 
 * Last modified: 08/28/2005
 */

using System;
using System.Collections;

namespace StateMachineToolkit
{
	/// <summary>
	/// Represents a collection of substates.
	/// </summary>
	public class SubstateCollection : ICollection
	{
        #region SubstateCollection Members

        #region Fields

        // The owner of the collection. The States in the collection are 
        // substates to this State.
        private State owner;

        // The collection of substates.
        private ArrayList substates = new ArrayList();

        #endregion

        #region Construction

        /// <summary>
        /// Initializes a new instance of the SubstateCollection with the 
        /// specified owner.
        /// </summary>
        /// <param name="owner">
        /// The owner of the collection.
        /// </param>
		public SubstateCollection(State owner)
		{
            this.owner = owner;
        }

        #endregion

        #region Methods

        /// <summary>
        /// Adds the specified State to the collection.
        /// </summary>
        /// <param name="substate">
        /// The State to add to the collection.
        /// </param>
        public void Add(State substate)
        {
            #region Preconditions

            if(owner == substate)
            {
                throw new ArgumentException(
                    "State cannot be a substate to itself.");
            }
            else if(substates.Contains(substate))
            {
                throw new ArgumentException(
                    "State is already a substate to this state.");
            }
            else if(substate.Superstate != null)
            {
                throw new ArgumentException(
                    "State is already a substate to another State.");
            }

            #endregion

            substate.Superstate = owner;
            substates.Add(substate);
        }

        /// <summary>
        /// Removes the specified State from the collection.
        /// </summary>
        /// <param name="substate">
        /// The State to remove from the collection.
        /// </param>
        public void Remove(State substate)
        {
            if(substates.Contains(substate))
            {
                substate.Superstate = null;
                substates.Remove(substate);

                if(owner.InitialState == substate)
                {
                    owner.InitialState = null;
                }
            }
        }

        #endregion

        #endregion

        #region ICollection Members

        public bool IsSynchronized
        {
            get
            {
                return false;               
            }
        }

        public int Count
        {
            get
            {
                return substates.Count;
            }
        }

        public void CopyTo(Array array, int index)
        {
            substates.CopyTo(array, index);
        }

        public object SyncRoot
        {
            get
            {
                return this;
            }
        }

        #endregion

        #region IEnumerable Members

        public IEnumerator GetEnumerator()
        {
            return substates.GetEnumerator();
        }

        #endregion
    }
}

By viewing downloads associated with this article you agree to the Terms of Service and the article's licence.

If a file you wish to view isn't highlighted, and is a text file (not binary), please let us know and we'll add colourisation support for it.

License

This article, along with any associated source code and files, is licensed under The Code Project Open License (CPOL)

Share

About the Author

Leslie Sanford

United States United States
Aside from dabbling in BASIC on his old Atari 1040ST years ago, Leslie's programming experience didn't really begin until he discovered the Internet in the late 90s. There he found a treasure trove of information about two of his favorite interests: MIDI and sound synthesis.
 
After spending a good deal of time calculating formulas he found on the Internet for creating new sounds by hand, he decided that an easier way would be to program the computer to do the work for him. This led him to learn C. He discovered that beyond using programming as a tool for synthesizing sound, he loved programming in and of itself.
 
Eventually he taught himself C++ and C#, and along the way he immersed himself in the ideas of object oriented programming. Like many of us, he gotten bitten by the design patterns bug and a copy of GOF is never far from his hands.
 
Now his primary interest is in creating a complete MIDI toolkit using the C# language. He hopes to create something that will become an indispensable tool for those wanting to write MIDI applications for the .NET framework.
 
Besides programming, his other interests are photography and playing his Les Paul guitars.

| Advertise | Privacy | Mobile
Web04 | 2.8.140926.1 | Last Updated 26 Oct 2006
Article Copyright 2005 by Leslie Sanford
Everything else Copyright © CodeProject, 1999-2014
Terms of Service
Layout: fixed | fluid