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中的子图形的位置和大小。