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。有一点很重要：
  ChangeListener是在button的Model里，并且响应任何鼠标动作，包括点击和移过。同时，因为两个Model都加到
  了同一个ButtonGroup上，所以同一时间只有一个可以被选中。
    为了让一个父图形能够“理解”子图形的一个Rectangle constraint，你必须使用名为XYLayout的布局管理器
  （LayoutManager）。下面将讨论LayoutManager以及他们如何使得你控制Figure中的子图形的位置和大小。