欢迎光临
我们一直在努力

arrow flex是什么List - AS3 Flex

语言版本:  ActionScript 3.0
产品版本:  Flex 4
运行时版本:  Flash Player 10, AIR 1.5

List 控件可显示垂直项目列表。其功能与 HTML 中的 SELECT 表单元素的功能相似。如果包含的项目太多无法同时显示,则会显示一个垂直滚动条,以便用户可访问列表中的所有项目。可以选择使用水平滚动条,以便用户在列表项目的整个宽度不适合时查看项目。用户可以根据 allowMultipleSelection 属性的值从列表中选择一个或多个项目。

注意:基于 Spark List 的控件(Spark ListBase 类及其子类,如 ButtonBar、ComboBox、DropDownList、List 和 TabBar)不支持将 BasicLayout 类作为 layout 属性的值。不要将 BasicLayout 与基于 Spark List 的控件一起使用。指定布局时,不应该设置布局的 typicalLayoutElement 属性;会将其自动设置为使用 List 的 typicalItem 创建的项呈示器。

要在基于列表的组件(如 List 或 DataGrid)中使用此组件,请创建项呈示器。有关创建项呈示器的信息,请参阅自定义 Spark 项呈示器。

List 控件具有下列默认特征:

expanded隐藏 MXML 语法

The <s:List> tag inherits all of the tag
attributes of its superclass and adds the following tag attributes:

  <s:List
    Properties
    allowMultipleSelection="false"
    dragEnabled="false"
    dragMoveEnabled="false"
    dropEnabled="false"
    selectedIndices="null"
    selectedItems="null"
    useVirtualLayout="true"

    Styles
    alternatingItemColors="undefined"
    borderAlpha="1.0"
    borderColor="0#CCCCCC"
    borderVisible="true"
    contentBackgroundColor="0xFFFFFF"
    downColor="0xA8C6EE"
    dragIndicator="ListItemDragProxy"
    dropIndicatorSkin="ListDropIndicator"
    rollOverColor="0xCEDBEF"
    selectionColor="0xA8C6EE"
    symbolColor="0x000000"
  />
  

dataProvider

查看示例


样式为常见样式,或与特定主题关联。如果为常见样式,则可以用于任何主题。如果样式与特定主题关联,则只有应用程序使用该主题时才能使用该样式。

  样式 说明 由以下参数定义 String 是
语言版本: ActionScript 3.0
 产品版本: Flex 4
 运行时版本: Flash10, AIR 1.5

指定该元素的哪条基线对齐到 alignmentBaseline 以确定元素在该行上的垂直位置. Class 否
语言版本: ActionScript 3.0
 产品版本: Flex 4
 运行时版本: Flash10, AIR 1.5

用于在由 List 启动的拖放操作过程中为拖放指示符创建实例的类。必须为 IFlexDisplayObject 类型。

如果该类实现 ILayoutManagerClient 接口,则由 DragManager 验证实例。

如果该类实现 IVisualElement 接口,则将实例的 owner 属性设置为启动拖动的 List。

AIR DragManager 对实例拍摄快照,而非 AIR DragManager 直接使用该实例。

默认值为 spark.components.supportClasses.ListItemDragProxy。 Class 否
语言版本: ActionScript 3.0
 产品版本: Flex 4
 运行时版本: Flash10, AIR 1.5

如果 dropIndicator 外观部件未在 List 外观中指定,则将在 List 为潜在放置目标的拖放操作过程中创建此类的实例,并将其用于默认拖放指示符。

默认值为 spark.skins.spark.ListDropIndicator。 String 否
语言版本: ActionScript 3.0
 产品版本: Flex 4
 运行时版本: Flash10, AIR 1.5

指示在哪些条件下会显示水平滑动条。

  • ScrollPolicy.ON(“on”)- 始终显示滚动条。
  • ScrollPolicy.OFF(“off”)- 从不显示滚动条。通过设置视域的 horizontalScrollPosition 属性,仍可以按编程方式滚动视域。
  • ScrollPolicy.AUTO(“auto”)- 当视域的 contentWidth 大于其自身的宽度时显示滚动条。

滚动策略影响 Scroller 外观部件的测量大小。此样式仅仅是 scroller 外观部件 horizontalScrollPolicy 的封面。它不是继承样式,例如它不会影响项呈示器。

在手机应用程序中使用水平 List 控件时,请将 horizontalScrollPolicy 设置为 on,并将 verticalScrollPolicy 设置为 auto,以启用水平跳动和拉动效果。否则,控件将使用垂直跳动和拉动效果。

默认值为 ScrollPolicy.AUTO

String 否
语言版本: ActionScript 3.0
 产品版本: Flex 4
 运行时版本: Flash10, AIR 1.5

指示在哪些条件下会显示垂直滑动条。

  • ScrollPolicy.ON(“on”)- 始终显示滚动条。
  • ScrollPolicy.OFF(“off”)- 从不显示滚动条。通过设置视域的 verticalScrollPosition 属性,仍可以按编程方式滚动视域。
  • ScrollPolicy.AUTO(“auto”)- 当视域的 contentHeight 大于其自身的高度时显示滚动条。

滚动策略影响 Scroller 外观部件的测量大小。此样式仅仅是 Scroller 外观部件 verticalScrollPolicy 的封面。它不是继承样式,例如它不会影响项呈示器。

在手机应用程序中使用水平 List 控件时,请将 horizontalScrollPolicy 设置为 on,并将 verticalScrollPolicy 设置为 auto,以启用水平跳动和拉动效果。否则,控件将使用垂直跳动和拉动效果。

默认值为 ScrollPolicy.AUTO

  样式 说明 由以下参数定义 Array Color 是 spark, mobile
语言版本: ActionScript 3.0
 产品版本: Flex 4
 运行时版本: Flash10, AIR 1.5

列表中项目使用的背景色。此值是由一种或多种颜色组成的数组。列表项目的背景将交替使用此数组中的各种颜色。

Spark 主题的默认值为 undefined。Mobile 主题的默认值为 0xFFFFFF

Number 否 spark, mobile
语言版本: ActionScript 3.0
 产品版本: Flex 4
 运行时版本: Flash10, AIR 1.5

此组件的边框的 Alpha。

默认值为 1.0。 uint Color 否 spark, mobile
语言版本: ActionScript 3.0
 产品版本: Flex 4
 运行时版本: Flash10, AIR 1.5

此组件的边框的颜色。

默认值为 #696969。 Boolean 否 spark, mobile
语言版本: ActionScript 3.0
 产品版本: Flex 4
 运行时版本: Flash10, AIR 1.5

控制此组件的边框的可见性。

默认值为 true。 uint Color 是 spark, mobile
语言版本: ActionScript 3.0
 产品版本: Flex 4
 运行时版本: Flash10, AIR 1.5

此组件内容背景的颜色。

对于 List,更改 contentBackgroundColor 会更改 List 的内容背景色,但是,如果项呈示器为不透明,则用户可能看不到任何差别。项呈示器的颜色受 alternatingItemColors 影响。在 Spark 主题中,默认情况下,项呈示器是透明的 (alternatingItemColors = undefined);但是在 Mobile 主题中,项呈示器默认为不透明 (alternatingItemColors = 0xFFFFFF)。

Spark 主题的默认值为 0xFFFFFF。Mobile 主题的默认值为 0xF0F0F0

uint Color 是 spark
语言版本: ActionScript 3.0
 产品版本: Flex 4
 运行时版本: Flash10, AIR 1.5

鼠标位于组件上时加亮的颜色。

该样式只能应用在鼠标 interactionMode 中。

默认值为 0xCEDBEF。 uint Color 是 spark, mobile
语言版本: ActionScript 3.0
 产品版本: Flex 4
 运行时版本: Flash10, AIR 1.5

用户选中呈示器时其背景的颜色。

Halo 主题的默认值为 0x7FCEFF。Spark 主题的默认值为 0xA8C6EE。Mobile 主题的默认值为 0xE0E0E0

uint Color 是 spark, mobile
语言版本: ActionScript 3.0
 产品版本: Flex 4
 运行时版本: Flash10, AIR 1.5

组件的任何元件的颜色。示例包括 CheckBox 的复选标记或滚动按钮的箭头.

默认值为 0x000000

  样式 说明 由以下参数定义 Array Color 是 spark, mobile
语言版本: ActionScript 3.0
 产品版本: Flex 4
 运行时版本: Flash10, AIR 1.5

列表中项目使用的背景色。此值是由一种或多种颜色组成的数组。列表项目的背景将交替使用此数组中的各种颜色。

Spark 主题的默认值为 undefined。Mobile 主题的默认值为 0xFFFFFF

Number 否 spark, mobile
语言版本: ActionScript 3.0
 产品版本: Flex 4
 运行时版本: Flash10, AIR 1.5

此组件的边框的 Alpha。

默认值为 1.0。 uint Color 否 spark, mobile
语言版本: ActionScript 3.0
 产品版本: Flex 4
 运行时版本: Flash10, AIR 1.5

此组件的边框的颜色。

默认值为 #696969。 Boolean 否 spark, mobile
语言版本: ActionScript 3.0
 产品版本: Flex 4
 运行时版本: Flash10, AIR 1.5

控制此组件的边框的可见性。

默认值为 true。 uint Color 是 spark, mobile
语言版本: ActionScript 3.0
 产品版本: Flex 4
 运行时版本: Flash10, AIR 1.5

此组件内容背景的颜色。

对于 List,更改 contentBackgroundColor 会更改 List 的内容背景色,但是,如果项呈示器为不透明,则用户可能看不到任何差别。项呈示器的颜色受 alternatingItemColors 影响。在 Spark 主题中,默认情况下,项呈示器是透明的 (alternatingItemColors = undefined);但是在 Mobile 主题中,项呈示器默认为不透明 (alternatingItemColors = 0xFFFFFF)。

Spark 主题的默认值为 0xFFFFFF。Mobile 主题的默认值为 0xF0F0F0

uint Color 是 mobile
语言版本: ActionScript 3.0
 产品版本: Flex 4.5
 运行时版本: Flash10.1, AIR 2.5

按下项呈示器时其背景的颜色

如果 downColor 设置为 undefined,将不使用 downColor

Spark 主题的默认值为 undefined。Mobile 主题的默认值为 0xE0E0E0

uint Color 是 spark, mobile
语言版本: ActionScript 3.0
 产品版本: Flex 4
 运行时版本: Flash10, AIR 1.5

用户选中呈示器时其背景的颜色。

Halo 主题的默认值为 0x7FCEFF。Spark 主题的默认值为 0xA8C6EE。Mobile 主题的默认值为 0xE0E0E0

uint Color 是 spark, mobile
语言版本: ActionScript 3.0
 产品版本: Flex 4
 运行时版本: Flash10, AIR 1.5

组件的任何元件的颜色。示例包括 CheckBox 的复选标记或滚动按钮的箭头.

默认值为 0x000000

allowMultipleSelection:Boolean

语言版本:  ActionScript 3.0
产品版本:  Flex 4
运行时版本:  Flash Player 10, AIR 1.5

如果为 true,则会启用多项选择。在运行时进行切换时,会清除当前选择。当 interactionModetouch 时,不应将其打开。

默认值为 false。

    public function get allowMultipleSelection():Boolean
    public function set allowMultipleSelection(value:Boolean):void

dragEnabled:Boolean

语言版本:  ActionScript 3.0
产品版本:  Flex 4
运行时版本:  Flash Player 10, AIR 1.5

一个标志,指示是否可以将项目拖出此控件并放到其它控件上。如果设置为 true,则表示可以在该控件中进行拖动。如果 dropEnabled 属性同样设置为 true,您就可以在该控件中拖放项目进行重新排序。

不支持在 interactionMode 设置为 touch 的手机设备上执行拖放操作。

默认值为 false。

    public function get dragEnabled():Boolean
    public function set dragEnabled(value:Boolean):void

dragMoveEnabled:Boolean

语言版本:  ActionScript 3.0
产品版本:  Flex 4
运行时版本:  Flash Player 10, AIR 1.5

一个标志,指示在拖放操作过程中是否可以移动控件中的项目,而不只是从控件中复制这些项目。如果此属性设置为 truedragEnabled 属性设置为 true,就可以移动项目。通常情况下,不能或不应移除数据提供程序中的项目,因此在拖放过程中不应允许移动操作。

不支持在 interactionMode 设置为 touch 的手机设备上执行拖放操作。

默认值为 false。

    public function get dragMoveEnabled():Boolean
    public function set dragMoveEnabled(value:Boolean):void

dropEnabled:Boolean

语言版本:  ActionScript 3.0
产品版本:  Flex 4
运行时版本:  Flash Player 10, AIR 1.5

一个标志,指示是否可以将所拖动的项目放到此控件上。

如果将此属性设置为 true,则该控件将接受所有数据格式,并假定所拖动的数据与数据提供程序中数据的格式相匹配。如果要显式检查正在拖动的数据的数据格式,您必须处理一个或多个拖动事件(如 dragEnterdragOver),并调用 DragEvent 的 preventDefault() 方法来自定义列表类接受拖放数据的方式。

不支持在 interactionMode 设置为 touch 的手机设备上执行拖放操作。

默认值为 false。

    public function get dropEnabled():Boolean
    public function set dropEnabled(value:Boolean):void

hasFocusableChildren:Boolean[覆盖]

语言版本:  ActionScript 3.0
产品版本:  Flex 4
运行时版本:  Flash Player 10, AIR 1.5

一个标志,指示此 List 可获得焦点的项呈示器能够获得键盘焦点。

注意:此属性与 Flash Player 使用的 tabChildren 属性类似。应该将 hasFocusableChildren 属性用于 Flex 应用程序。请勿使用 tabChildren 属性。

此属性通常为 false,因为大多数组件既可以自己获得焦点,也可以委托单个内部子组件获得焦点(但显示为该组件获得了焦点)。可以选择在 List 中将此项设置为 true,以使该 List 中的内容可获得焦点。

如果设置为 true,且 List 外观包含 Scroller 外观部件,该值则由其下的 Scroller 代理。

如果该值为 true,此代理表示 Scroller 的内容(如项呈示器)现在可获得焦点。例如,这表示第一个 Tab 键击会将焦点置于 List 控件,第二个 Tab 键击会将焦点置于 Scroller 中可获得焦点的第一个子代。

如果为 false,则第一个 Tab 键击会将焦点置于 List 控件,第二个 Tab 键击会将焦点移至 List 后下一个可获得焦点的控件。

默认值为 false。

    override public function get hasFocusableChildren():Boolean
    override public function set hasFocusableChildren(value:Boolean):void

pageScrollingEnabled:Boolean

语言版本:  ActionScript 3.0
产品版本:  Flex 4.6
运行时版本:  AIR 3

页面滚动当前是否对此 Scroller 启用

默认值为 false。

    public function get pageScrollingEnabled():Boolean
    public function set pageScrollingEnabled(value:Boolean):void

scrollSnappingMode:String

语言版本:  ActionScript 3.0
产品版本:  Flex 4.6
运行时版本:  AIR 3

滚动贴紧模式当前对此 Scroller 生效

将此属性更改为不同于“none”的任何值可能导致滚动位置立即发生变化,以确保一个元素正确地“贴紧”到位置。这种滚动位置的变化不是动画

默认值为 "none"。

    public function get scrollSnappingMode():String
    public function set scrollSnappingMode(value:String):void

selectedIndices:Vector.<int>

语言版本:  ActionScript 3.0
产品版本:  Flex 4
运行时版本:  Flash Player 10, AIR 1.5

表示当前选定的一个或多个项目的索引的 int 的 Vector。如果已通过将 allowMultipleSelection 设置为 false 来禁用多项选择,且已设置此属性,则会选择与 Vector 中第一个索引相对应的数据项目。

如果通过将 allowMultipleSelection 设置为 true 来启用多项选择,该属性将包含选定索引列表,其中选定索引按选择顺序的相反顺序列出。这表示 Vector 中第一个元素与选定的最后一项相对应。

默认值为 []。

此属性可用作数据绑定的源。修改此属性后,将调度 valueCommit 事件。

    public function get selectedIndices():Vector.<int>
    public function set selectedIndices(value:Vector.<int>):void

selectedItems:Vector.<Object>

语言版本:  ActionScript 3.0
产品版本:  Flex 4
运行时版本:  Flash Player 10, AIR 1.5

表示当前选定数据项的 Object 的 Vector。如果已通过将 allowMultipleSelection 设置为 false 来禁用多项选择,且已设置此属性,则会选择与 Vector 中第一个项目相对应的数据项目。

如果通过将 allowMultipleSelection 设置为 true 来启用多项选择,该属性将包含选定项列表,其中选定索引按选择顺序的相反顺序列出。这表示 Vector 中第一个元素与选定的最后一项相对应。

默认值为 []。

此属性可用作数据绑定的源。修改此属性后,将调度 valueCommit 事件。

    public function get selectedItems():Vector.<Object>
    public function set selectedItems(value:Vector.<Object>):void

useVirtualLayout:Boolean[覆盖]

语言版本:  ActionScript 3.0
产品版本:  Flex 4
运行时版本:  Flash Player 10, AIR 1.5

设置与此控件相关联的布局的 useVirtualLayout 属性的值。如果该布局随后被替换,且此属性的值为 true,则会将新布局的 useVirtualLayout 属性设置为 true

默认值为 true。

    override public function get useVirtualLayout():Boolean
    override public function set useVirtualLayout(value:Boolean):void

public function List()

语言版本:  ActionScript 3.0
产品版本:  Flex 4
运行时版本:  Flash Player 10, AIR 1.5

构造函数。

public function addDragData(dragSource:DragSource):void

语言版本:  ActionScript 3.0
产品版本:  Flex 4
运行时版本:  Flash Player 10, AIR 1.5

作为拖放操作的一部分,将所选项目添加到 DragSource 对象。覆盖此方法可将其它数据添加到拖动源。

:DragSource — 在其中添加数据的 DragSource 对象。

override protected function adjustSelection(index:int, add:Boolean = false):void

语言版本:  ActionScript 3.0
产品版本:  Flex 4
运行时版本:  Flash Player 10, AIR 1.5

调整选定索引以说明正添加到此组件或正从此组件中删除的项目。

:int — 新索引。

:Boolean (default = false) — 如果已将项目添加到组件,则为 true;如果已删除项目,则为 false

protected function adjustSelectionAndCaretUponNavigation(event:KeyboardEvent):void

语言版本:  ActionScript 3.0
产品版本:  Flex 4
运行时版本:  Flash Player 10, AIR 1.5

根据遇到的键击或键击组合,调整所选项。将键击向下发送到布局,布局的 getNavigationDestinationIndex() 方法根据当前处于焦点的项确定导航到的索引。索引确定后,将更新单项选择、caret 项以及(如有必要)多项选择,以反映新选择的项。

:KeyboardEvent — 遇到 Keyboard 事件

protected function calculateSelectedIndices(index:int, shiftKey:Boolean, ctrlKey:Boolean):Vector.<int>

语言版本:  ActionScript 3.0
产品版本:  Flex 4
运行时版本:  Flash Player 10, AIR 1.5

Helper 方法,用于计算单击某项时当前所选项目如何发生变化。

:int — 已单击的项的索引。 :Boolean — 按下 Shift 键时为 true。 :Boolean — 按下 Ctrl 键时为 true。

Vector.<int> — 新所选项目将提交到的更新后的项索引。

protected function copyItemWithUID(item:Object):Object

语言版本:  ActionScript 3.0
产品版本:  Flex 4
运行时版本:  Flash Player 10, AIR 1.5

通过调用 ObjectUtil.copy() 方法为此对象制作一个深层副本,然后通过调用 UIDUtil.createUID() 方法用一个新值替代该副本的 uid 属性(如果存在)。

此方法用于拖放副本。

:Object — 要复制的项目。

Object — 对象的副本。

public function createDragIndicator():IFlexDisplayObject

语言版本:  ActionScript 3.0
产品版本:  Flex 4
运行时版本:  Flash Player 10, AIR 1.5

为用于在拖放操作过程中显示已拖动项的视觉效果的类创建实例。默认 DragEvent.DRAG_START 处理函数将此实例传送给 DragManager.doDrag() 方法。

IFlexDisplayObject — 代表拖动指示符的 IFlexDisplayObject。

public function createDropIndicator():DisplayObject

语言版本:  ActionScript 3.0
产品版本:  Flex 4
运行时版本:  Flash Player 10, AIR 1.5

为用于在拖放操作过程中显示拖放位置的视觉效果的 dropIndicator 类创建实例。此实例在布局的 dropIndicator 属性中设置。

如果覆盖 dragEnter 事件处理函数,并调用 preventDefault() 以免执行默认处理函数,则请调用 createDropIndicator() 创建拖放指示符。

DisplayObject — 返回在布局中设置的 dropIndicator。

public function destroyDropIndicator():DisplayObject

语言版本:  ActionScript 3.0
产品版本:  Flex 4
运行时版本:  Flash Player 10, AIR 1.5

释放当前在布局中设置的 dropIndicator 实例。

如果覆盖 dragExit 事件处理函数,并调用 preventDefault() 以免执行默认处理函数,则请调用 destroyDropIndicator() 删除拖放指示符。

DisplayObject — 返回删除的 dropIndicator。

public function ensureIndexIsVisible(index:int):void

语言版本:  ActionScript 3.0
产品版本:  Flex 4
运行时版本:  Flash Player 10, AIR 1.5

滚动数据项以使其可见的简便处理方法。如果指定索引的数据项未完全显示,List 将滚动,直到数据项显示出来。如果数据项已显示出来,则不会发生任何其它滚动。

:int — 数据项的索引。

<?xml version="1.0"?>
<!-- Simple example to demonstrate the Spark List component -->
<s:Application xmlns:fx="http://ns.adobe.com/mxml/2009" xmlns:s="library://ns.adobe.com/flex/spark">

    <fx:Script>
        <![CDATA[
            import spark.events.IndexChangeEvent;

            //this function is called when the selection is going to change
            private function selectionChangingHandler(evt:IndexChangeEvent):void 
            }
        ]]>
    </fx:Script>

    <s:Panel title="Spark List Component Example"
            width="75%" height="75%"
            horizontalCenter="0" verticalCenter="0">
        <s:VGroup left="20" right="20" top="20" bottom="20">
            <s:Label width="330"
                text="Select a name to see employee's phone number. You should not be able to select the first name."/>
            <s:List id="list" changing="selectionChangingHandler(event);">
                <!-- itemRenderer is inline in this sample -->
                <s:itemRenderer>
                    <fx:Component>
                        <s:ItemRenderer>
                            <s:states>
                                <s:State name="normal" />
                                <s:State name="hovered" />
                                <s:State name="selected" />
                            </s:states>
                            <s:Rect left="0" right="0" top="0" bottom="0">
                                <s:fill>
                                    <s:SolidColor color="0x999999" alpha="0" alpha.hovered="0.2"
                                            alpha.selected="0.6" />
                                </s:fill>
                             </s:Rect>
                             <s:Label id="nameLabel" text="{data.lastName}, {data.firstName}" top="5" left="5" right="5" />
                             <s:Label y="20" id="phoneLabel" text="{data.phone}" includeIn="selected" top="25" bottom="5" left="5" right="5" />
                        </s:ItemRenderer>
                    </fx:Component>
                </s:itemRenderer>
                <s:dataProvider>
                    <s:ArrayList>
                        <fx:Object type="hr" firstName="Ann"  lastName="Green"  />
                        <fx:Object type="employee" firstName="Tom"  lastName="Smith" phone="415-155-1212" />
                        <fx:Object type="employee" firstName="John" lastName="Black" phone="408-344-1234" />
                        <fx:Object type="employee" firstName="Jane" lastName="White" phone="415-235-7878" />
                        <fx:Object type="employee" firstName="Bill" lastName="Jones" phone="415-875-7800" />
                    </s:ArrayList>
                </s:dataProvider>
            </s:List>
        </s:VGroup>
     </s:Panel>

</s:Application>


赞(0)
未经允许不得转载:上海聚慕医疗器械有限公司 » arrow flex是什么List - AS3 Flex

登录

找回密码

注册