GEF 进阶，第三部分: Layer

简介： 在GEF中，画板是由多个Layer(层)组成的，层也可以看作是对图形进行的一种分类管理，它使图形更加明确，层次清晰。程序结构上也更容易理解和维护。层同样也是可以定制的，本文演示如何实现并插入一个自定义层，并指出了插入自定义层所应该注意的一些问题。

Layer(层)

GEF的图形是可能分布在多个层上面的，比如连线是放在Connection Layer(连接层)上的，而普通的图形（比如Shapes Example里面的长方形和椭圆）是放置在Primary Layer(主层)上的。不同类型的图形放置在不同的层上，既易于管理又结构清晰，因此层是一个非要重要的功能。层其实也是一个图形，和其他图形一样都继承自Figure类，所以我们也可以象添加普通图形一样添加层，只不过方式有点不同而已。

我们首先需要知道层是在哪里创建的，才好动手修改它们。在GEF中，每一个EditPart Viewer都有一个特殊的EditPart，叫做Root，而层的创建就在其中。因此要添加自定义的层，首先的任务就是扩展Root EditPart，一般来说，我们使用的是ScalableFreeformRootEditPart。

提示: 使用何种Root EditPart也是可以自己控制的，只需要在重载GraphicalEditor的configureGraphicalViewer方法，指定使用我们自己的Root EditPart即可。以下是一段示例代码，斜黑体部分就是具体的调用：

protected void configureGraphicalViewer() {super.configureGraphicalViewer();GraphicalViewer viewer = getGraphicalViewer();viewer.setRootEditPart(new ScalableFreeformRootEditPart());// more code……………}

所以，这是我们能够自定义层的一个前提。

ScalableFreeformRootEditPart的createLayers()方法是创建层的关键所在，仔细观察其实现，不难看出GEF缺省定义了如图1所示的层次结构:

提示: 先添加的层在下，后添加的层在上

我们看到缺省包含了很多层，而且层中还有子层，每个层都有一个关键字来标识，我们从下到上做一个简要的描述：

• Grid Layer: 网格层，用来显示一个网格，帮助你定位图形
• Primary Layer: 主层，大部分的图形都放置在这个层
• Connection Layer: 连接层，连线都放置在这一层
• Printable Layer: 可打印层，这个层并没有实际作用，只是用来包含主层和连接层
• Scaled Feedback Layer: 扩展反馈层，所谓反馈是指操作时显示的一些提示信息，比如你拖动一个图形时，会显示一个虚影，这就是反馈
• Scalable Layer: 和Printable Layer一样，只是一个容器层
• Handle Layer: Handle是指一些可以拖动的小方块，比如选择一个图形时，会显示八个用于Resize的Handle
• Feedback Layer: 也是一个反馈层
• Guide Layer: 帮助层

所有的层我们都可以通过getLayer()方法得到，因此我们有很大的自由去控制这些层的属性，但是如果我们要添加一个层或者修改一个层的行为，我们必须实现自己的RootEditPart。

Background Layer (背景层)

出于演示的目的，我们添加一个比较简单的层，叫做Background Layer，它的用处就是在画布上显示一个渐进的背景，我们把这个层添加到Primary Layer之前，避免覆盖主层上的图形。

注意，我们添加的这个层只是出于演示目的，实际上添加一个背景色并不用费此周章。我们只是为了说明如何添加一个自定义的层。

创建BackgroundLayer类

我们首先来创建类，对于层，我们只要继承Layer类就可以了，而Layer本身继承自Figure，它没有添加任何新的方法，如果你扩展过Figure类的话，对此就应该比较熟悉了。由于我们只是画个渐进背景色，所以只需要重载一下paintFigure方法就可以了。如下

package org.eclipse.gef.examples.shapes.layer;import org.eclipse.draw2d.ColorConstants;import org.eclipse.draw2d.FreeformLayer;import org.eclipse.draw2d.Graphics;public class BackgroundLayer extends FreeformLayer {public static final String BACKGROUND_LAYER = "Background Layer";public BackgroundLayer() {setOpaque(true);}@Overrideprotected void paintFigure(Graphics graphics) {if(isOpaque()) {graphics.setForegroundColor(ColorConstants.white);graphics.setBackgroundColor(ColorConstants.lightBlue);graphics.fillGradient(getBounds(), true);}}}

我们最终扩展的是FreeformLayer而不是Layer, 如果直接扩展Layer的话，我们的层会无法自动改变大小。我们推荐从FreeformLayer开始你的工作。

实现MyRootEditPart

由于我们只需要插入一个层，所以我们重载ScalableFreeformRootEditPart中的createPrintableLayers方法就可以了。再次提醒的是要注意插入的位置，先加入的层在下，后加入的在上。

package org.eclipse.gef.examples.shapes.parts;import org.eclipse.draw2d.ConnectionLayer;import org.eclipse.draw2d.FreeformLayer;import org.eclipse.draw2d.FreeformLayeredPane;import org.eclipse.draw2d.LayeredPane;import org.eclipse.gef.editparts.ScalableFreeformRootEditPart;import org.eclipse.gef.examples.shapes.layer.BackgroundLayer;public class MyRootEditPart extends ScalableFreeformRootEditPart {@Overrideprotected LayeredPane createPrintableLayers() {FreeformLayeredPane layeredPane = new FreeformLayeredPane();layeredPane.add(new BackgroundLayer(), BackgroundLayer.BACKGROUND_LAYER);layeredPane.add(new FreeformLayer(), PRIMARY_LAYER);layeredPane.add(new ConnectionLayer(), CONNECTION_LAYER);return layeredPane;}}

让我们自定义的RootEditPart生效是相当简单的事，只要修改ShapesEditor. configureGraphicalViewer()，将ScalableFreeformRootEditPart替换为MyRootEditPart即可。就不列出代码了。完成之后我们就可以看到画板有了一个渐进式的背景，如图2所示:

结束语

GEF中的几乎一切东西都可以定制，本文介绍的是层的定制，层对于一个复杂图形应用（比如布线程序）来说是非常重要的。GEF的RootEditPart是层创建的地方，同时getLayer()方法可以让我们方便的访问层对象，而添加一个自定义层也是相当简单。