【Flex Viewer】 开发教程（4）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);

              }

           }

 

           private function openHandler():void{⑤

              Alert.show("HelloWidgetTemplateWidget open");

           }

 

           private function minimizedHandler():void{⑥

              Alert.show("HelloWidgetTemplateWidget minimized");

           }

 

           private 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事件的响应方法。