Flex Viewer 开发教程（3）Widget与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);

                            }

                     }

 

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