admin管理员组

文章数量:1531657

2024年5月12日发(作者:)

ActionScript编程 使用列表框组件

作用:

列表框(List)组件用于显示基于列表的信息,用户可以选择该列

表中的一项或多项。

说明:

List组件是一个可滚动的单选或多选列表框,该列表还可以显示图

形和其它组件。使用m()和mAt()方法可以将项添加

到列表中。List组件由item、row和data provider构成,其介绍如下所

示:

Item ActionScript对象,通常包含label属性和data属性,前者是描述

性的属性,后者用于存储与项目关联的数据。

Row 用于显示项目的组件。

Data provider:一个组件,用于模拟List组件所显示的项目。

创建List组件实例的方法如下所示。

import ;

//导入List类

var list:List = new List();

List组件实例可以获取或设置的属性如下所示。

iconField 获取或设置用于提供项的图标的项字段。默认值为“icon”。

iconFunction 获取或设置用于获得项的图标的函数。默认值为null。

labelField 获取或设置dataProvider对象中的字段名称,该字段名称将

显示为TextInput字段和下拉列表的标签。默认情况下,组件将显示各

dataProvider项目label属性。如果dataProvider项目不包含label属性,

则可以设置labelField属性以使用其它属性。默认值为“label”。

 labelFunction 获取或设置用于获得项的标签的函数。默认情况下,组

件将显示dataProvider项目的label属性。但某些数据集可能没有label

字段,或者没有不需修改其值即可用作标签的字段。

rowCount 获取或设置在列表中至少部分可见的行的行数。

rowHeight 获取或设置列表中每一行的高度,以像素为单位。默认值

为20。

List组件实例包含有4个方法,用于实例创建新的实例、检索默认

样式、滚动列表的功能,详细介绍如下所示。

List() 创建新的List组件实例。

getStyleDefinition() 检索当前组件的默认样式映射。

itemToLabel() 基于labelField和labelFunction属性检索渲染器将为给

定数据对象显示的字符串。该方法包含一个item参数,表示要呈现的

对象。

 scrollToIndex() 将列表滚动至位于指定索引处的项目。如果索引超出

范围,则滚动位置不发生变化。该方法包含一个newCaretIndex参数,

表示要滚动到的索引位置。

默认情况下,List组件使用CellRenderer类提供在其中显示列表项

目的行。可以通过编程方式创建这些行,这通常通过细分CellRenderer

类来完成。CellRenderer类实现ICellRenderer接口,该接口提供一组属

性和方法,List组件可以使用这些属性和方法对其中的行进行操作,并

将数据和状态信息发送到各行以供显示。

示例:

创建一个名称为list的列表框组件实例,该实例的列表中包含有7

个星期日期。通过设置rowCount属性,使其默认只显示2行选项。如

果想要显示或选择其它选项,用户可以向上或向下拖动滚动条,如下

所示。

import ovider;

import ;

//导入所需的类

var dp:DataProvider = new DataProvider();

m({label:"星期日"});

m({label:"星期一"});

m({label:"星期二"});

m({label:"星期三"});

m({label:"星期四"});

m({label:"星期五"});

m({label:"星期六"});

var list:List = new List();

nt = 2;

//定义默认显示为2行

ovider = dp;

//定义列表框组件的数据源

addChild(list);

本文标签: 组件列表属性显示用于