GEF Programmers' Guide 中文版(工具和绘图板)

工具


(Tools)


和绘图板


( Palette


)


GEF
的工具处理几乎可以所有的事件，在
GEF
中，
EditDomain
用来记录当前有效地工具。

应用程序可能会选择使用绘图板
(PaletteViewer)
来显示多种工具，它允许用户在不用的工具集之间切换。

工具如何工作



工具的实现有点像状态机，
SWT
的事件
(Event)
驱动状态机工作。根据事件和当前状态，工具将执行特定的处理，这些处理包括：

1.

请示
EditPart
是否显示反馈


2.

从
EditPart
中得到命令


3.

在命令栈
(Command Stack)
中执行命令


4.

更新鼠标光标，比如有时候有手型，有时候则为指针型


工具的激活需要通过
EditDomain
，在一个
EditDomain
中的所有
Viewer
只能拥有同一个工具。

如果使用了绘图板，从绘图板中选择某个工具也会激活它。

选择工具


(The Selection Tool


)


选择工具是
GEF
中最基本的工具，一般也是应用程序一开始默认的工具。我们可以委托选择工具来处理任何
EditPart
。它会从
EditPart
获得一种叫做拖拽跟踪者
(DragTacker)
的辅助工具，也会在鼠标进行拖拽时响应。拖拽
(Drag)
是鼠标在按下与松开之间进行的任何操作，这期间会产生很多事件。事件被转发给代理，然后根据拖拽发生的时间和位置来进行不同的处理。例如，点击一个
Handle(
选中图形时图形边框上出现的柄状节点，一般在四个角和边框的中点位置
)
可能会带来形状大小的修改，或者连接端点的移动。





值得一提的是，选择工具并不选中
EditPart
，所有的鼠标点击都作为拖拽来处理。当选择工具接收到一个针对
EditPart
的鼠标按下事件时，它会请求获得一个拖拽跟踪
(Tracker)
。
EditPart
使用
SelectEditPartTracker
来获取跟踪，它不但跟踪鼠标按下事件，而且还包括鼠标松开之前的所有事件。
Tracker
甚至还处理鼠标的双击事件。

更多选择工具和
Tracker
的信息请参考选择交互一节。

绘图板
(
Palette)




GEF
的
PaletteViewer
使用的是
SWT
控件，它提供了一系列的工具可供用户选择。同时
PaletteVIewer
也可以作为拖拽的源，允许用户直接把对象从绘图板中拖到图形中。绘图板虽然不是必需的，但是使用非常普遍。

我们可以指定绘图板的位置，甚至可以放在编辑器里。
GEF
提供了一个
WorkbenchView
来放置绘图板，同时一个自定义的面板——
FlyoutPaletteComposite
将负责管理
PaletteViewer
的位置，一般地
PaletteViewer
位于主控件的旁边。

在
Logic
示例中，这个面板就是编辑器的主控件，见下图：



PaletteViewer
显示绘图模型，一般以根模型
(PaletteRoot)
开始。
PaletteRoot
使用可以展开合拢的目录抽屉
(Drawer)
或者组
(Group)
来组织各种绘图模型。每个组成员都可以包含绘图元素
(Palette Entry)
。绘图元素或者是一个工具，或者是一个模板
(Template)
。模板将在下面的创建一节中讲述。

绘图板提供几种显示模式，比如只显示图标。你也可以提供一个自定义的模式，允许用户自己修改或创建绘图板内容。