.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方式，插入如下代码：
<StackPanelGrid.Row="1"Grid.Column="0"Orientation="Vertical"Margin="10">
……
<CheckBoxName="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做上标记。
（待续）
