Flex 列表控件

1.列表控件标签

<mx:List>

常用属性：

除继承ListBase类的属性外，还包括如下常用属性：

在editedPosition属性中，条目编辑的位置通常为行和列的序号，如｛columnIndex:0,rowIndex:3｝。列表控件的序号都是从0开始。

2.列表控件事件：

列表控件的事件除继承ListBase类的事件外还包括编辑时的事件。

itemEditBegin:当对条目进行编辑，即editedItemPosition属性被赋值时，触发该事件。该事件表明条目处于准备被编辑的状态。

itemEditBeginning:用户单击条目时进入itemEditBegin状态，在用户释放鼠标时，触发该事件，进入条目编辑状态。

itemEditEnd:完成条目编辑。当编辑后的数据从条目编辑器中保存到数据提供器中时，触发该事件。

itemFocusIn:当鼠标焦点停留在条目渲染器时，触发该事件。

itemFocusOut：当条目渲染器失去鼠标焦点时，触发该事件。

scroll：如果控件中出现滚动条，则拖动滚动条时触发该事件。

（上述几个事件的事件对象类型均为mx.events.ListEvent）

3.创建列表控件

<?xml version="1.0" encoding="utf-8"?>
<s:WindowedApplication xmlns:fx="http://ns.adobe.com/mxml/2009" 
                       xmlns:s="library://ns.adobe.com/flex/spark" 
                       xmlns:mx="library://ns.adobe.com/flex/mx" fontSize="14">
    <fx:Declarations>
        <!-- 将非可视元素（例如服务、值对象）放在此处 -->
    
    
    <fx:Model id="myPhone">
        <!--定义列表控件所需的数据-->
        <states>
            <state label="诺基亚" data="nokia"/>
            <state label="摩托罗拉" data="moto"/>
            <state label="索爱" data="se"/>
            <state label="三星" data="sum"/>
            <state label="Palm" data="pal"/>
            <state label="黑莓" data="bb"/>
            <state label="联想" data="le"/>
            <state label="其他" data="etc"/>
        </states>
    </fx:Model>
</fx:Declarations>
    
    <mx:Panel title="列表控件例子" paddingTop="10" paddingBottom="10" paddingLeft="10" paddingRight="10" width="340">
        <mx:Label text="选择手机品牌"/>
        <!--定义列表控件，数据提供器为myPhone中state的内容，控件自动读取label标签内容显示-->
        <mx:List id="source" color="blue" width="100%" height="100%"
                       dataProvider="{myPhone.state}"
                        rollOverColor="#80FF00"/>
        
    </mx:Panel>
</s:WindowedApplication>

其中：rollOverColor="#80FF00"表示改变鼠标停留在条目上时条目高亮的颜色。

效果如图：

使用labelFunction属性时，该属性指向的方法有其固定的格式，方法的参数为列表中的条目，类型为Object,返回新定义的标签值，类型为String,代码如下：

<?xml version="1.0" encoding="utf-8"?>
<s:WindowedApplication xmlns:fx="http://ns.adobe.com/mxml/2009" 
                       xmlns:s="library://ns.adobe.com/flex/spark" 
                       xmlns:mx="library://ns.adobe.com/flex/mx" fontSize="14">
    <fx:Script>
        <![CDATA[
            //定义列表数据标签显示的函数，参数为列表中条目
            //返回值为每个条目的label和data属性的组合
            public function myLabelFunc(item:Object):String{
               return item.data + "," + item.label;
            }
        ]]>
    </fx:Script>
    
    <fx:Declarations>
        <!-- 将非可视元素（例如服务、值对象）放在此处 -->
    
    
    <fx:Model id="myPhone">
        <!--定义列表控件所需的数据-->
        <states>
            <state label="诺基亚" data="nokia"/>
            <state label="摩托罗拉" data="moto"/>
            <state label="索爱" data="se"/>
            <state label="三星" data="sum"/>
            <state label="Palm" data="pal"/>
            <state label="黑莓" data="bb"/>
            <state label="联想" data="le"/>
            <state label="其他" data="etc"/>
        </states>
    </fx:Model>
</fx:Declarations>
    
    <mx:Panel title="列表控件例子" paddingTop="10" paddingBottom="10" paddingLeft="10" paddingRight="10" width="340">
        <mx:Label text="选择手机品牌"/>
        <!--定义列表控件，数据提供器为myPhone中state的内容，控件自动读取label标签内容显示-->
        <mx:List id="source" color="blue" width="100%" height="100%"
                       dataProvider="{myPhone.state}"
                        rollOverColor="#80FF00" labelFunction="myLabelFunc"/>
        
    </mx:Panel>
</s:WindowedApplication>

效果如图：

4.列表控件事件

<?xml version="1.0" encoding="utf-8"?>
<s:WindowedApplication xmlns:fx="http://ns.adobe.com/mxml/2009" 
                       xmlns:s="library://ns.adobe.com/flex/spark" 
                       xmlns:mx="library://ns.adobe.com/flex/mx" fontSize="14">
    <fx:Script>
        <![CDATA[
            
            import mx.controls.Alert;
            import mx.events.ListEvent;
            //定义单击数据条目的方法
            private function itemClickEvent(event:ListEvent):void{
             mx.controls.Alert.show(event.target.selectedItem.label,"详细信息");
            }
            //定义鼠标在条目上滚动的方法
            private function itemRollEvent(event:ListEvent):void{
             detail.text="单击选定品牌";
            }
        ]]>
    </fx:Script>
    
    <fx:Declarations>
        <!-- 将非可视元素（例如服务、值对象）放在此处 -->
    
    
    <fx:Model id="myPhone">
        <!--定义列表控件所需的数据-->
        <states>
            <state label="诺基亚" data="nokia"/>
            <state label="摩托罗拉" data="moto"/>
            <state label="索爱" data="se"/>
            <state label="三星" data="sum"/>
            <state label="Palm" data="pal"/>
            <state label="黑莓" data="bb"/>
            <state label="联想" data="le"/>
            <state label="其他" data="etc"/>
        </states>
    </fx:Model>
</fx:Declarations>
    
    <mx:Panel title="列表控件例子" paddingTop="10" paddingBottom="10" paddingLeft="10" paddingRight="10" width="340">
        <mx:Label text="选择手机品牌"/>
        <!--定义列表控件，数据提供器为myPhone中state的内容，控件自动读取label标签内容显示-->
        <mx:List id="source" color="blue" width="100%" height="100%"
                       dataProvider="{myPhone.state}"
                        rollOverColor="#80FF00" itemClick="itemClickEvent(event)"
                        itemRollOut="itemRollEvent(event)"/>
        
    </mx:Panel>
</s:WindowedApplication>