Flex Viewer 开发教程3Widget与WidgetTemplate

1        Widget 与WidgetTemplate

HelloWorldWidget中短短几行代码，却能实现如此cool的一个Widget，这要归功于WidgetTemplate。WidgetTemplate是IWidgetTemplate接口的默认实现，提供组成Widget的各个部分，包括标题栏、内容面板、控制按钮、工具按钮、Widget图标等等。Widget将WidgetTemplate作为UI容器，比如在HelloWorldWidget中，我们将显示信息的Label放在WidgetTemplate中。当然，也可以实现自定义WidgetTemplate，只要实现IWidgetTemplate接口即可。在Flex Viewer2.0以后，WidgetTemplate的外观通过皮肤（Skin）来定义，详见WidgetTemplateSkin代码。要想实现其它风格的WidgetTemplate，自定义一个WidgetTemplateSkin即可。下图是一个自定义WidgetTemplateSkin的效果。

 

 WidgetTemplate定义了三个事件：打开（open）、最小化（minimized）、关闭（closed）。这三个事件分别在Widget打开、最小化和关闭的时候发生。这三个事件在某些特殊业务需求下能发挥很大的作用，比如某个Widget对应的一个Graphicslayer（见ArcGIS API for Flex），当Widget打开时需要显示，当Widget最小化或者关闭时需要隐藏。此需求可以分别在三个事件的响应方法中实现。在HelloWidgetTemplateWidget中我们分别对三个事件进行响应，每个响应中显示一个弹出框来说明当前所发生的事件类型。窗口打开时的情形如下图所示：

HelloWidgetTemplateWidget代码如下：

<?xml version="1.0" encoding="utf-8"?> <viewer:BaseWidget xmlns:fx="http://ns.adobe.com/mxml/2009"                                xmlns:s="library://ns.adobe.com/flex/spark"                                xmlns:mx="library://ns.adobe.com/flex/mx"                                xmlns:viewer="com.esri.viewer.*"                                layout="absolute" width="400" height="300"                                widgetConfigLoaded="init()">        <fx:Script>               <![CDATA[                      import mx.controls.Alert;                        [Bindable]                      private var helloContent:String;                        private function init():void{                             if (configXML){                                    helloContent=String(configXML.hellocontent);                             }                      }                        function openHandler():void{⑤                             Alert.show("HelloWidgetTemplateWidget open");                      }                        function minimizedHandler():void{⑥                             Alert.show("HelloWidgetTemplateWidget minimized");                      }                        function closedHandler():void{⑦                             Alert.show("HelloWidgetTemplateWidget closed");                      }               ]]>        </fx:Script>        <viewer:WidgetTemplate open="openHandler()"①                 minimized="minimizedHandler()"② closed="closedHandler()"③                 skinClass="widgets.FlexViewerInAction.HelloWidgetTemplate. WidgetTemplateSkin"④>               <s:HGroup width="100%" height="100%"                               horizontalAlign="center" verticalAlign="middle">                      <s:Label text="{helloContent}"/>               </s:HGroup>        </viewer:WidgetTemplate> </viewer:BaseWidget>

        ①     设置open事件的响应方法；

        ②     设置minimized事件的响应方法；

        ③     设置closed事件的响应方法；

        ④     设置WidgetTemplate的皮肤；

        ⑤     实现open事件的响应方法；

        ⑥     实现minimized事件的响应方法；

        ⑦     实现closed事件的响应方法。