destroyballsworker.cs

C#开发的运行于windows mobile ＰＤＡ上的游戏

////////////////////////////////////////////////
// 
// Project: Lines.NET
// Version: 1.1
// Author:  Vladimir L.
// 
// homepage: http://www.boomsoft.org
// e-mail:   [e-mail]
// 
// Copyright (c) 2003-2004, Boomsoft.org
// 

using System;
using System.Threading;

namespace Lines.Core
{
	/// <summary>
	/// Animates balls destruction.
	/// </summary>
	/// <remarks>
	/// Collapses the balls one after another with a pause between collapses 
	/// that is defined by application settings <see cref="AppSettings.PauseDestroyBall"/>.
	/// Supposed to be started in a separate thread.
	/// </remarks>
	/// <example>
	/// <code>
	/// DestroyBallsWorker worker = new DestroyBallsWorker(game, balls);
	/// Thread destroyThread = new Thread(new ThreadStart(worker.Execute));
	/// destroyThread.Start();
	/// </code>
	/// </example>
	public class DestroyBallsWorker
	{
		/// <summary>
		/// Holds the reference to a game object.
		/// </summary>
		private Game game;
		/// <summary>
		/// The array of balls to destroy.
		/// </summary>
		private Ball[] balls;
		/// <summary>
		/// The cached value of destroy pause.
		/// </summary>
		/// <remarks>
		/// This value is taken from <see cref="AppSettings.PauseDestroyBall"/> property.
		/// </remarks>
		private int pause = AppSettings.Instance.PauseDestroyBall;

		/// <summary>
		/// Creates an instance of destroy balls worker.
		/// </summary>
		/// <param name="game">The reference to a game object.</param>
		/// <param name="balls">The array of balls to destroy.</param>
		public DestroyBallsWorker(Game game, Ball[] balls)
		{
			this.game = game;
			this.balls = balls;
		}
		
		/// <summary>
		/// Executes the destruction.
		/// </summary>
		/// <remarks>
		/// This method is supposed to be used as an entry point for a thread.
		/// </remarks>
		public void Execute()
		{
			for (int i = 0; i < balls.Length; i++)
			{
				Ball ball = balls[i];
				Thread.Sleep(pause);
			}
		}
	}
}