使用 C＃开发智能手机软件：推箱子(二十二)

这是“使用 C＃开发智能手机软件：推箱子” 系列文章的第二十二篇。在这篇文章中，介绍 Window/MainForm.Replay.cs 源程序文件。这个源程序文件是 MainForm 类的一部分，该类继承自 System.Windows.Forms.Form 类，表示推箱子的主窗体。而本篇文章讲述的是推箱子“回放”过程，如下图所示：

我们先看看 MainForm.Designer.cs 源程序文件(该文件是由 Visual Studio 2005 IDE 自动生成的)中和“回放”相关的部分：

namespace Skyiv.Ben.PushBox.Window
{
  partial class MainForm
  {
      // 注意：省略了很多代码，仅保留和 miReplayOrLand 相关的部分。
    private void InitializeComponent()
    {
      this.miReplayOrLand = new System.Windows.Forms.MenuItem();
      this.mnuMain.MenuItems.Add(this.miReplayOrLand);
      this.miReplayOrLand.Text = "回放";
      this.miReplayOrLand.Click += new System.EventHandler(this.miReplayOrLand_Click);
    }
    private System.Windows.Forms.MenuItem miReplayOrLand;
  }
}

上述代码片断展示了在推箱子游戏的主窗体上点击“回放”时发生的事件：

this.miReplayOrLand.Click += new System.EventHandler(this.miReplayOrLand_Click);

也就是说如果以前使用“录像”功能保存过通关步骤的话，可以通过“回放”功能将该通关步骤重新播放出来。这是由下面的 MainForm.Replay.cs 源程序代码实现的：

1 using System;
2 using System.Drawing;
3 using System.Threading;
4 using Skyiv.Ben.PushBox.Common;
5
6 namespace Skyiv.Ben.PushBox.Window
7 {
8   partial class MainForm
9   {
10     Rectangle workerThreadInvalidRectangle;
11     bool workerThreadIsStop;
12
13     private void miReplayOrLand_Click(object sender, EventArgs e)
14     {
15       if (env.IsDesign)
16       {
17         env.Pen = Block.Land;
18         UpdateStatus();
19       }
20       else
21       {
22         env.IsReplay = true;
23         workerThreadIsStop = false;
24         UpdateStatus();
25         ThreadPool.QueueUserWorkItem(WorkerThreadReplay, env.GetSteps());
26       }
27     }
28
29     /// <summary>
30     /// 回放通关步骤,使用后台工作线程
31     /// </summary>
32     /// <param name="steps">通关步骤</param>
33     private void WorkerThreadReplay(object steps)
34     {
35       try
36       {
37         foreach (char c in (string)steps)
38         {
39           if (workerThreadIsStop) break;
40           if (env.ReplayDelay > 0) Thread.Sleep(env.ReplayDelay);
41           Step step = c;
42           if (!env.StepIt(step.Direct, step.IsStop, out workerThreadInvalidRectangle)) break;
43           Invoke(new EventHandler(WorkerThreadUpdateStatus));
44         }
45       }
46       finally
47       {
48         env.IsReplay = false;
49         Invoke(new EventHandler(WorkerThreadUpdateStatus));
50       }
51     }
52
53     /// <summary>
54     /// 更新主窗体状态
55     /// </summary>
56     /// <param name="sender">事件源</param>
57     /// <param name="e">不包含任何事件数据的事件参数</param>
58     void WorkerThreadUpdateStatus(object sender, EventArgs e)
59     {
60       Invalidate(workerThreadInvalidRectangle);
61       UpdateStatus();
62     }
63   }
64 }
65
66

几点说明：

因为“回放”是一个长时间的过程，为了防止用户界面失去响应，所以使用了多线程技术，在后台工作线程进行回放。也说是将回放通关步骤的 WorkerThreadReplay 方法加入到线程池中去：ThreadPool.QueueUserWorkItem(WorkerThreadReplay, env.GetSteps());
workerThreadInvalidRectangle 字段(Rectangle 类型)表明“回放”时主窗体需要更新的矩形区域。该值是由 Env 类的 StepIt 方法设定。
workerThreadIsStop 字段(bool 类型)指示是否停止回放，初始值为 false。当用户按“停止”按钮时，该字段被设置为 true，从而停止回放。
miReplayOrLand_Click 方法响应用户的“回放”请求，启动后台“回放”线程。
WorkerThreadReplay 方法在后台线程执行实际的“回放”动作，她实际上是对已经保存的通关步骤的每一步调用 Env 类的 StepIt 方法来进行“回放”，并通过 Invoke 调用 WorkerThreadUpdateStatus 方法更新主窗体状态。
WorkerThreadUpdateStatus 方法负责更新主窗体状态。
如果在智能手机上进行“回放”，就是不使用后台线程，用户界面也不会失去响应，不知是什么原因。