GXT之旅：第八章：Portal&Drag-Drop——Portal的基本介绍

第八章：Portal&Drag-Drop

本章我们要了解GXT的Portal&Drag-Drop功能。我们会首先学习如何使用Portal（非常类似谷歌的iGoogle功能）布局和Portlet，然后再以实践的方式学习GXT的拖拽功能。

我们会涉及到如下GXt功能集

Portal
Portlet

Draggable

DragSource

GridDropTarget
ListViewDropTarget
TreeGridDropTarget
TreePanelDropTarget

ColumnLayout
RowLayout

Portlet class

Portlet 类继承自ContentPanel，她提供了一种特殊的panel，可以在Viewport的Portal容器里，随意的更改显示位置和大小。她很像widows系统里面的桌面应用。

新建一个Portlet的过程很类似于其他容器的创建。

Portlet portlet = new Portlet();
portlet.setHeight(150);
portlet.setHeading("Example Portlet");

运行效果如下：

portal.setPinned(true);

设置其是否可以被重置位置。除此之外，Portlet继承ContentPanel的所有功能

Portal class

Portal是专门为Portlet设置的容器。事实上，其容器包含了一组按照ColumnLayout布局的LayoutContainer。其中每一个LayoutContainer都包含一个Portlet，布局效果为RowLayout。

Portal同样支持Portlet的拖拽功能。Portal里面会有列，每一个列里面又包含行。因此就有了表格的概念，所以当新建一个Portal的时候，我们就需要在构造函数里，设置有多少列。当然还得通过setColumnWidth()方法设置其每一列的宽度。

假如，我们想创建一个两列的，分别是30％，70％宽的Portal的时候。我们会有如下代码

Portal portal = new Portal(2);
portal.setColumnWidth(0, 0.3);
portal.setColumnWidth(1, 0.7);

当Portal定义好了之后，我们要往每一列里放入Portlet（其宽度自动的跟着column的宽度适应，只需要设置高度既可）

Portlet portlet1 = new Portlet();
portlet1.setHeight(150);
portlet1.setHeading("Example Portlet 1");
portal.add(portlet1, 0);

Portlet portlet2 = new Portlet();
portlet2.setHeight(150);
portlet2.setHeading("Example Portlet 2");
portal.add(portlet2, 1);

生成后的效果如下：



左右两个Portlet可以被拖拽到不同的位置。当一个Portlet正在被拖拽的时候，其效果如下



当右侧的portlet被拖拽到左侧的时候，会自动的改变宽度

ToolButton

正是因为Portlet继承了ContentPanel，所以我们可以在其头部添加ToolButton。这样一来，可以让Portlet在功能和显示效果上，更接近桌面的应用窗口。

portlet.getHeader().addTool(new ToolButton("x-tool-minimize"));
portlet.getHeader().addTool(new ToolButton("x-tool-maximize"));
portlet.getHeader().addTool(new ToolButton("x-tool-close"));

如上的三行代码，就会构建出如下的效果