第八章: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"));
如上的三行代码,就会构建出如下的效果