Draw2D教程（二）
2、Draw2d Figures
构建一个Draw2d GUI需要写很多代码。但是，区别于 SWT/JFace的GUI元素，Draw2d的组件支持移动以及其他
各种操作，这些组件都是Figure的子类实例。Figure的这些子类构成Draw2d GUI的可视部分。图C.3列出了其中的
一部分子类，它们都是很重要的。
图C.3列出的子类普遍应用于我们的flowchart中，尤其是那些和Connection、Layer相关的。但首先，我们需
要整体上介绍一下Figure。
图C.3
2.1、Figure 的方法
如同SWT中的Control，Fgure类有许多方法来操作它的属性。在这里我们不可能将其137个方法一一列举，但这
些方法大致可分为四类：
a 操作Figure的可视部分
b 事件处理
c 跟踪parent和children
d 管理图形
下面分别介绍一下这四类方法：
操作Figure的可视部分
这类方法和SWT是一样的。包括设置Figure的bounds, location, size等参数，你可以控制Figure的最大/最小
尺寸、边框的大小、可视区域等。还包括设置Figure的前景色背景色，焦点控制以及是否可见等。
Draw2d的事件处理
Draw2d事件处理过程也与SWT类似，但提供了一些新的events和listeners。不同于SWT，Figure可以处理很多其
自己的事件。所有的listeners和他们的处理方法列于表C.2：
表C.2
前5个addXXX方法与SWT的基本一样，addListener()可以接收无类型的事件。最后三个则是Draw2d所特有的。
addAncestorListener()方法如同Swing的同名方法一样，响应该Figure的各级容器（祖先）的改变。同样，方法
FigureListener响应Figure的移动事件。
最后一个，addPropertyChangeListener(),使得你可以定制自己的事件。当你的Figure中的某个属性改变时，
手工调用此方法，则注册到该属性上的PropertyChangeListeners就会被唤醒。
Parent 和 child Figure
在SWT中，一个组件可以通过一个Composite放到另一个组件之上。但在Draw2d的世界中，任何Figure都可以充
当其他Figure的容器。所以Draw2d使用parent和child来代指容器Figure和其上的子Figure。表C.3给出了创建这
种父子关系的方法：
表C.3
在SWT中，类似Button，Label这些组件是通过构造函数的参数来将自己加到一个Composite上的，但在Draw2d中，
则是由parent调用add()方法，将一个child加入，同时还可以跟一个参数，指明这个child的大小或者位置，以及
在children List中的次序。Parent Figure可以通过getChildren()来取得所有的子图形，反之child则使用方法
getParent()来访问自己的父图形。父图形还可以使用setChildrenEnabled()方法来启用/禁用某个子图形，或者
调用setConstraint()来移动子图形。
管理图形
尽管Draw2d提供了Graphics类来充当SWT中的GC角色（即绘图功能），但Figure还是有几个自己的绘图方法。它
们不仅可以通过paint()方法来控制自身的显示，而且可以使用paintBorder()和paintClientArea()来选择显示哪
一部分。Figure还可以用paintChildren()方法来控制children的显示，或者paintFigure()来只显示自身。同时，
Figure还重载了几个类似SWT的repaint方法。
Draw2d还提供有确定用户鼠标选择区域的方法。这不同于SWT，因为前者特别关注鼠标的精确位移，而后者只关心
用户选取了哪一个Control。Figure的这些方法包括findMouseEventAt()和findFigureAt()等。
2.2、使用Labels和Clickbles
首先让我们来看一下Figure的子类中最简单的：Label和Clickble。这两种组件与SWT中的同名组件差不多，但是仍
有一些有趣的不同之处。
Lables
Draw2d的Label类似SWT的Label，但包含更多的方法来用作对文本以及对图片的定位。例如，对于文本，可以用方法
getTextLocation()和getTextBounds()来测定其位置和大小。同样，如果这个Label上有Image，那么可以使用方法
getIconBounds()和getIconAlignment()方法。
Clickables
Clickble包括Button和Toggle。如同SWT的Button，可以使用style将其设置为toggle（即按下不会自动弹起的按钮
），checkbox，或者正常的push按钮。你也可以控制它的状态，文本以及图片。但Draw2d的Clickble和SWT的Button有
两个重要的不同：第一、Clickble可以使用任意的Draw2d Figure；第二、Clickble的事件处理与SWT有所不同。
Draw2d用户界面一般来说比SWT/JFace的要更复杂些，所以，一个Clickble的状态信息由一个ButtonModel或者Togg
leModel对象来管理。这样就分离了组件的行为和显示，使得我们容易分而治之。你也可以把这些Model对象放在同一个
ButtonGroup里面，这样可以同时管理多个Clickble。
Clickble通过调用fireChangeEvent()方法来更新它的Model对象，就如同Figure利用firePropertyChangeEvent()
一样。Clickble的属性常量定义在Modle类中，比如MOUSEOVER_PROPERTY 和 PRESSED_PROPERTY，当它们改变的时候
，Model就会发出一组Draw2d事件，或者通知它的ButtonGroup（默认）。
例程
列表C.1的代码不会在我们的flowchart中用到，但是它展示了Draw2d的Clickble，Model以及ButtonGroup如何一起
协作，在例程中我们使用了Clickble的子类CheckBox，然后给它设置了一个ToggleModel。
列表C.1：Draw2D_Example,java
package com.swtjface.AppC;
import org.eclipse.swt.widgets.*;
import org.eclipse.draw2d.*;
import org.eclipse.draw2d.Label;
import org.eclipse.draw2d.geometry.*;
public class Draw2D_Example
{
public static void main(String args[])
{
final Label label = new Label("Press a button!");
Shell shell = new Shell();
LightweightSystem lws = new LightweightSystem(shell);
Figure parent = new Figure();
parent.setLayoutManager(new XYLayout());
lws.setContents(parent);
Clickable above = new CheckBox("I'm above!");
parent.add(above, new Rectangle(10,10,80,20));
ButtonModel aModel = new ToggleModel();
aModel.addChangeListener(new ChangeListener()
{
public void handleStateChanged(ChangeEvent e)
{
label.setText("Above");
}
});
above.setModel(aModel);
Clickable below = new CheckBox("I'm below!");
parent.add(below, new Rectangle(10,40,80,20));
ButtonModel bModel = new ToggleModel();
bModel.addChangeListener(new ChangeListener()
{
public void handleStateChanged(ChangeEvent e)
{
label.setText("Below");
}
});
below.setModel(bModel);
ButtonGroup bGroup = new ButtonGroup();
bGroup.add(aModel);
bGroup.add(bModel);
bGroup.setDefault(bModel);
parent.add(label, new Rectangle(10,70,80,20));
shell.setSize(130,120);
shell.open();
shell.setText("Example");
Display display = Display.getDefault();
while (!shell.isDisposed())
{
if (!display.readAndDispatch())
display.sleep ();
}
}
}
如你所见，Draw2d应用程序不过是一个SWT的Shell和一个LightweightSystem再加上Figures。有一点很重要：
ChangeListern是在button的Model里，并且响应任何鼠标动作，包括点击和移过。同时，因为两个Model都加到
了同一个ButtonGroup上，所以同一时间只有一个可以被选中。
为了让一个父图形能够“理解”子图形的一个Rectangle constraint，你必须使用名为XYLayout的布局管理器
（LayoutManager）。下面将讨论LayoutManager以及他们如何使得你控制Figure中的子图形的位置和大小。
