.Net Framework3.0 实践纪实(4)

 .Net Framework3.0 实践纪实(4)

 

可视对象和棋子

任务1.6的实现和画棋纵横线没有很大的差别，设置好字体、要显示的坐标的文字，然后调用DrawingContext的DrawText方法在指定的位置画出对象即可。为了满足任务中的要求，我们设置一个开关字段和对应的属性，代码如下：

   public partial class BoardControl : Canvas

    {

        double scale = 0.03;

        readonly int[,] demarkCount ={ { 2, 3 }, { 3, 3 }, { 3, 4 }, { 3, 5 }, { 3, 6 } };

        bool showCoordinate = true;

        Brush coordinateColor = Brushes.White;

 

       ……

 

        public bool ShowCoordinate

        {

            get { return showCoordinate; }

            set

            {

                if (showCoordinate != value)

                {

                    showCoordinate = value;

                    InvalidateVisual();

                }

            }

        }

 

……..

        protected override void OnRender(DrawingContext dc)

        {

           ……

            if (showCoordinate)

            {

                double fontSize = 0.4;

 

                for (int i = 1; i <= BoardSize; i++)

                {

                    FormattedText fmtText = new FormattedText(i.ToString(), CultureInfo.CurrentCulture, FlowDirection.LeftToRight, new Typeface("Arial"), fontSize, coordinateColor);

                    fmtText.TextAlignment = TextAlignment.Right;

                    dc.DrawText(fmtText, new Point(-0.5, (i - 1 - fmtText.Height * .5)));

                    fmtText =new FormattedText(((char)(i + 64)).ToString(), CultureInfo.CurrentCulture, FlowDirection.LeftToRight, new Typeface("Arial"), fontSize, coordinateColor);

                    fmtText.TextAlignment = TextAlignment.Center;

                    dc.DrawText(fmtText, new Point(i - 1, BoardSize - 0.5));

                }

            }

        }

……

编译运行。为了测试显示隐藏坐标的功能，切换到MainWindow的Xaml方式，插入如下代码：

      < StackPanel Grid.Row = "1"Grid.Column="0"Orientation="Vertical"Margin="10">

        ……

                < CheckBox Name = "coordinateCheckBox"Click="ShowCoordinateClick"IsChecked="True"

                  FontSize = "14"Foreground="White"FontWeight="Bold"Margin="10">Show Coordinate</CheckBox>

 

      </ StackPanel >

切换到Source方式，添加ShowCoordinateClick方法，代码如下：

……

private void ShowCoordinateClick(object sender, RoutedEventArgs e)

{

    boardControl.ShowCoordinate = coordinateCheckBox.IsChecked == true ? true : false;

}

……

重新运行程序，测试一下显示隐藏坐标的功能。

给任务1.6做上标记，到目前任务1中全部的子任务现在都已经完成，所以我们给任务1也做上标记。检查任务表，还有两个任务，那就是任务2和任务3。任务2明显要先于任务3。所以我们先处理任务2。

任务2：TopGo的棋盘必须可以在一个指定的位置显示指定颜色的棋子；

要完成任务2，同样我们可以把它分解成2个小任务：

2.1 在指定位置画黑色棋子

2.2 在指定位置画白色棋子

我们开始任务2.1：棋子怎么画？最简单的方法就是画一个黑色的圆，但为了更好的显示效果，我们可以给棋子加上光线效果，让棋子有立体感。因为棋盘背景的光线是从左上角到右下角，所以棋子的光线方向应该和棋盘一致。受目前的cider版本的限制，我们无法可视化的在xaml中设计棋子，但你可以使用sdk自带的xmalpad来进行这项工作，具体的操作就不详细描述了，我只是提一下设计思路：先画一个黑色的圆，然后在这个圆的右上角附近画一个小的椭圆，用白色到透明的辐射渐变填充这个小的椭圆来表示高光，调整小椭圆的位置。

在xmal的棋盘控件元素的子元素中，放置显示棋子的xaml代码，就可以显示棋子。不过进一步考虑之后我们发现：棋子的位置我们事先是不知道的。它必须先是在用户指定的地方，要解决这个问题，有几种方法，我们可以把棋子的显示绑定到一个棋子的集合中，但这种方法效率不高，因为每一次数据源发生变化，棋子就会重画，也就是说一盘棋右上百个棋子，如果每次都重画它，效果肯定好不了。如果我们在OnRender方法中像画棋盘纵横线那样画棋子，也存在其他方面的问题，比如窗体大小发生改变的时候，也需要手工的调用代码来重画每个棋子。在WPF中，对象是按照树型结构组织的，当显示父控件的时候，子控件是自动被计算并显示。所以我们可以把画出表示棋子的对象插入到棋盘的子控件集合中。不过，我们还是一步一步来进行，给我们的任务表插入如下任务：

2．1．1 画出黑色圆形

2．1．2 画出高光

任务2.1.1:

首先在OnRender方法中添加语句(仅仅为了开始我们的任务)，然后添加DrawStone的方法：

 

        protected override void OnRender(DrawingContext dc)

        {

            ……

            DrawBlackStone(dc, new Point(0,0));

      

        }

 

        private void DrawBlackStone(DrawingContext dc, Point pos)

        {

            EllipseGeometry stone = new EllipseGeometry(pos, 0.49, 0.49);

            dc.DrawGeometry(Brushes.Black, null, stone);

        }

 

我们这里没有使用Ellipse类，而是使用Geometry几何对象，主要的好处是我们可以直接指定圆的中点和半径，因为棋盘的网格的大小是1*1，我们的棋子必须略小于网格，这里设置为0.98，所以半径就是0.49。

编译运行。

任务2.1.2:

画棋的高光，我们先在左边的边缘画出一个椭圆高光，然后在旋转45度到正确的位置。在DrawStone方法中添加代码：

      private void DrawBlackStone(DrawingContext dc, Point pos)

        {

            EllipseGeometry stone = new EllipseGeometry(pos, 0.49, 0.49);

 

            EllipseGeometry highLight = new EllipseGeometry();

            highLight.Center = pos - new Vector(0.3, 0);

            highLight.RadiusX = 0.15;

            highLight.RadiusY = 0.25;

 

            LinearGradientBrush highLightBrush = new LinearGradientBrush(Colors.White, Colors.Transparent, new Point(0, 0), new Point(1, 0));

           

            dc.PushTransform(new RotateTransform(45, pos.X, pos.Y));

            dc.DrawGeometry(Brushes.Black, null, stone);

            dc.DrawGeometry(highLightBrush, null, highLight);

        }

编译运行，观看效果，基本能够达到我们的要求。通过设置pos参数，可以在不同的位置显示棋子（自行测试）。如果没有问题，就给任务2.1.1和任务2.1.2以及任务2.1做上标记。

能够画出黑棋，用同样的原理，我们也可以画出白棋，不过有一点不同就是白棋的底色我们做成了辐射渐变，具体参见代码：

在OnRender方法中添加代码：

        protected override void OnRender(DrawingContext dc)

        {

           ……

            DrawBlackStone(dc, new Point(0,0));

            DrawWhiteStone(dc, new Point(1, 0));

        }

 

       private void DrawWhiteStone(DrawingContext dc, Point pos)

        {

            EllipseGeometry stone = new EllipseGeometry(pos, 0.49, 0.49);

 

            EllipseGeometry highLight = new EllipseGeometry();

            highLight.Center = pos - new Vector(0.3, 0);

            highLight.RadiusX = 0.15;

            highLight.RadiusY = 0.25;

 

            LinearGradientBrush highLightBrush = new LinearGradientBrush(Colors.White, Colors.Transparent, new Point(0, 0), new Point(1, 0));

 

            RadialGradientBrush stoneBrush =new RadialGradientBrush(Colors.White, Colors.Gray);

            stoneBrush.GradientOrigin = new Point(0.25, 0.5);

            stoneBrush.RadiusX = 1.5;

            stoneBrush.RadiusY = 1.7;

 

            dc.PushTransform(new RotateTransform(45, pos.X, pos.Y));

            dc.DrawGeometry(stoneBrush, null, stone);

            dc.DrawGeometry(highLightBrush, null, highLight);

            dc.Pop();

        }

编译运行。

给任务2.2做标记。似乎也可以给任务2做标记，但是还不能，看一下代码，我们发现两个画棋子的方法有许多重复的代码，而且也有许多硬编码的数字。这是应该对代码进行重构的信号。

通过分析两个画棋子的代阿，我们发现除了黑白棋子使用的笔刷不同，其他的都一样，所以我们可以合并两个方法为一个方法，为了区分画的是白棋还是黑棋，我们引入一个枚举类型：

首先，在项目中添加一个新的文件：StoneColor.cs

代码如下：

    public enum StoneColor

    {

        None,

        Black,

       White

}

 

接着，我们在BoardControl类中，创建一个新的方法DrawStone:

       private void DrawStone(DrawingContext dc, Point pos, StoneColor color)

        {

            if(color==StoneColor.None)

                return;

 

            EllipseGeometry stone = new EllipseGeometry(pos, 0.49, 0.49);

 

            EllipseGeometry highLight = new EllipseGeometry();

            highLight.Center = pos - new Vector(0.3, 0);

            highLight.RadiusX = 0.15;

            highLight.RadiusY = 0.25;

 

            LinearGradientBrush highLightBrush = new LinearGradientBrush(Colors.White, Colors.Transparent, new Point(0, 0), new Point(1, 0));

 

            Brush stoneBrush = null;

            if (color == StoneColor.Black)

                stoneBrush = Brushes.Black;

            else

            {

                stoneBrush =new RadialGradientBrush(Colors.White, Colors.Gray);

                ((RadialGradientBrush)stoneBrush).GradientOrigin = new Point(0.25, 0.5);

                ((RadialGradientBrush)stoneBrush).RadiusX = 1.5;

                ((RadialGradientBrush)stoneBrush).RadiusY = 1.7;

            }

 

            dc.PushTransform(new RotateTransform(45, pos.X, pos.Y));

            dc.DrawGeometry(stoneBrush, null, stone);

            dc.DrawGeometry(highLightBrush, null, highLight);

            dc.Pop();

        }

修改OnRender中的两个调用方法为：

…

            DrawStone(dc, new Point(0,0),StoneColor.Black);

            DrawStone(dc, new Point(1, 0),StoneColor.White);

……

删除原来的DrawBlackStone和DrawWhiteStone

最后我们把硬编码的数字全部替换为常量：

重构的一个原则就是不能对原来的功能作修改。重构后的代码如下：

 

        const double STONE_R = 0.49;

    

        const double HIGH_LIGHT_OFFSET_X = 0.3;

        const double HIGH_LIGHT_OFFSET_Y = 0;

        const double HIGH_LIGHT_RX = 0.15;

        const double HIGH_LIGHT_RY = 0.25;

 

        const double STONE_BRUSH_ORIGIN_X = 0.25;

        const double STONE_BRUSH_ORIGIN_Y = 0.5;

        const double STONE_BRUSH_RX = 1.5;

        const double STONE_BRUSH_RY = 1.7;

        const double STONE_ROTATE_ANGLE = 45;

 

        private void DrawStone(DrawingContext dc, Point pos, StoneColor color)

        {

            if(color==StoneColor.None)

                return;

 

            EllipseGeometry stone = new EllipseGeometry(pos, STONE_R, STONE_R);

 

            EllipseGeometry highLight = new EllipseGeometry();

            highLight.Center = pos - new Vector(HIGH_LIGHT_OFFSET_X, HIGH_LIGHT_OFFSET_Y);

            highLight.RadiusX = HIGH_LIGHT_RX;

            highLight.RadiusY = HIGH_LIGHT_RY;

 

            LinearGradientBrush highLightBrush = new LinearGradientBrush(Colors.White, Colors.Transparent, new Point(0, 0), new Point(1, 0));

 

            Brush stoneBrush = null;

            if (color == StoneColor.Black)

                stoneBrush = Brushes.Black;

            else

            {

                stoneBrush =new RadialGradientBrush(Colors.White, Colors.Gray);

                ((RadialGradientBrush)stoneBrush).GradientOrigin = new Point(STONE_BRUSH_ORIGIN_X, STONE_BRUSH_ORIGIN_Y);

                ((RadialGradientBrush)stoneBrush).RadiusX = STONE_BRUSH_RX;

                ((RadialGradientBrush)stoneBrush).RadiusY = STONE_BRUSH_RY;

            }

 

            dc.PushTransform(new RotateTransform(STONE_ROTATE_ANGLE, pos.X, pos.Y));

            dc.DrawGeometry(stoneBrush, null, stone);

            dc.DrawGeometry(highLightBrush, null, highLight);

            dc.Pop();

        }

现在可以对任务2做上标记了。

任务3：棋子的位置可以通过鼠标来指定（准确地说是鼠标左键）

任务3看上去好像并不难，你只要注册BoardControl的鼠标事件，就可以得到鼠标的位置，然后把位置和颜色的信息传递回BoardControl就可以画出棋子，不过有些问题需要解决，让我们边做边看会是什么问题。

首先，我们不能在Xaml文件中像其他控件那样写MouseLeftButtonDown=”…”, Cider并不是别用户控件的事件，除非是重载这个事件，所以我们可以显式的在代码中进行注册：

在MainWindow的构造器中添加一行代码：

        public MainWindow()

        {

            InitializeComponent();

            boardControl.MouseLeftButtonDown +=new MouseButtonEventHandler(boardControl_MouseLeftButtonDown);

        }

 

通过智能提示，自动生成下面的方法签名：

        void boardControl_MouseLeftButtonDown(object sender, MouseButtonEventArgs e)

        {

            throw new Exception("The method or operation is not implemented.");

        }

 

为了传递数据给棋盘控件，我们也设计一个新的类Stone来表示我们的棋子对象，对项目添加一个新的类Stone, 代码如下：

    public class Stone

    {

        StoneColor color = StoneColor.None;

        Point position;

 

        public Stone() : this(StoneColor.None, new Point(-1, -1)) { }

 

        public Stone(StoneColor color, Point position)

        {

            this.color = color;

            this.position = position;

        }       

       

        public StoneColor Color

        {

            get { return color; }

            set { color = value; }

        }

 

        public Point Position

        {

            get { return position; }

            set { position = value; }

        }

}

向BoardControl传递数据，我们设想BoardControl有一个方法叫做AddStone（Stone stone）提供我们调用，所以 boardControl_MouseLeftButtonDown中的代码如下：

        void boardControl_MouseLeftButtonDown(object sender, MouseButtonEventArgs e)

        {

            Point pos = e.GetPosition(boardControl);

            pos.X=(int)Math.Floor(pos.X+0.5);

            pos.Y=(int)Math.Floor(pos.Y+0.5);

 

            Stone stone =new Stone(StoneColor.Black, pos);

            boardControl.AddStone(stone);

     }

代码中，我们必须鼠标返回的位置做四舍五入取整。否则棋子的位置可能会出现偏差。

然后我们在BoardControl中添加新的方法:

        public void AddStone(Stone stone)

        {

            DrawingVisual dv = new DrawingVisual();

            DrawingContext dc = dv.RenderOpen();

            DrawStone(dc, stone.Position, stone.Color);

            dc.Close();

        }

DrawingVisual是我们第一次见到的WPF的可视对象，它派生于Visual类，有关的资料参阅文档中的描述。

AddStone通过dv对象打开一个DrawingContext, 这样我们就可以调用DrawStone来画出棋子。删除OnRender中的最后两个调用DrawStone的语句，我们不需要它了。如果你现在编译运行，当你点击棋盘，期待出现黑色的棋子，结果一定让你失望。因为什么都没有发生！

这是因为在AddStone的方法中，创建的dv没有加入到棋盘的子控件中，很不幸的是，你不能把dv添加到Children中，因为Children要求UIEmemt类型或者派生类的对象。 解决的方法就是我们自己定义一个集合，然后重载BoardControld的GetVisualChild和VisualChildrenCount两个方法。

在BoardControl类中添加字段：

        VisualCollection stoneVisuals = null;

在构造器的开始创建stoneVisuals的实例：

        public BoardControl()

        {

            stoneVisuals =new VisualCollection(this);

            InitializeComponent();

        }

在AddStone方法的最后面添加一行代码：

       public void AddStone(Stone stone)

        {

            ……

            stoneVisuals.Add(dv);

        }

两个重载方法的代码：

        protected override Visual GetVisualChild(int index)

        {

            if (index < 0 || index > stoneVisuals.Count)

                return base.GetVisualChild(index);

 

            return stoneVisuals[index];

        }

 

        protected override int VisualChildrenCount

        {

            Get{ return stoneVisuals.Count;}

        }

 

重新编译运行。

你可以通过修改调用AddStone方法的stone参数的Color属性来看白色棋子的显示。

我们可以模拟下棋的时候黑白棋子交替的场景，只要做些许的修改：

切换到MainWindow的Source方式，添加一个字段：

        StoneColor currentColor = StoneColor.Black;

添加一个方法：

        private void ExchangColor()

        {

            currentColor = currentColor == StoneColor.White ? StoneColor.Black : StoneColor.White;

        }

 

最后修改boardControl_MouseLeftButtonDown方法中的代码如下：

        void boardControl_MouseLeftButtonDown(object sender, MouseButtonEventArgs e)

        {

            Point pos = e.GetPosition(boardControl);

            pos.X=(int)Math.Floor(pos.X+0.5);

            pos.Y=(int)Math.Floor(pos.Y+0.5);

 

            Stone stone =new Stone(currentColor, pos);

            boardControl.AddStone(stone);

 

            ExchangColor();

        }

通过模拟，我们发现了新的任务，我们注意到了几个问题，那就是不允许在已经有棋子的地方落子；第二个问题那就是我们可以落子，也必须能够删除已有的棋子，这在以后的功能开发中是必要的，比如在Undo或者提子（吃子）的场合。第三，为了方便打谱，必须有一个选项能够在棋子上面显示该棋子的手序。为此我们添加新的任务到任务表。

5、 检测禁止落子点

6、 显示和隐藏棋子的手序数

7、 提供回退和自动提子功能

别忘了给任务3做上标记。

（待续）