自定义 List 组件

在创作时和运行时,您都可以按水平方向和垂直方向将 List 组件变形。在创作时,在舞台上选择组件并使用“任意变形”工具或任何“修改”>“变形”命令。在运行时,使用 List.setSize() 方法(请参阅 UIObject.setSize())。

当调整列表的大小后,列表的行会在水平方向收缩,剪下其中的任何文本。在垂直方向,列表根据需要增加或删除行。滚动条自动对它们定位。有关滚动条的详细信息,请参阅ScrollPane 组件

对 List 组件使用样式

您可以设置样式属性以更改 List 实例的外观。

List 组件使用下列光晕样式:

样式

描述

alternatingRowColors

指定交替模式中行的颜色。它的值可以是两个或多个颜色(例如 0xFF00FF、0xCC6699 和 0x996699)组成的数组。

backgroundColor

列表的背景颜色。该样式在类样式声明 ScrollSelectList 上进行定义。

borderColor

三维边框的黑色部分或二维边框的彩色部分。

borderStyle

边框样式。可能的值包括:“none”、“solid”、“inset”和“outset”。该样式在类样式声明 ScrollSelectList 上进行定义。

defaultIcon

用于列表行的默认图标的名称。默认值未定义。

rollOverColor

滑过的行的颜色。

selectionColor

所选行的颜色。

selectionEasing

对用于控制编程补间的扩大公式(函数)的引用。

disabledColor

禁用的文本颜色。

textRollOverColor

指针在文本上滑过时,该文本的颜色。

textSelectedColor

选定文本时,该文本的颜色。

selectionDisabledColor

行被选中并禁用之后的颜色。

selectionDuration

选择项目时的任何转换的长度。

useRollOver

确定滑过一行时是否激活突出显示该行。

List 组件也使用 Label 组件(请参阅对 Label 组件使用样式)、ScrollBar 和 RectBorder 的样式属性。

使用具有 List 组件的外观

List 组件中的所有外观都包含在组成列表的子组件(ScrollPane 组件和 RectBorder)中。有关详细信息,请参阅 ScrollPane 组件。您可以使用 setStyle() 方法(请参阅 UIObject.setStyle())来更改下列 RectBorder 样式属性:

RectBorder 样式

边框位置

borderColor

a

highlightColor

b

borderColor

c

shadowColor

d

borderCapColor

e

shadowCapColor

f

shadowCapColor

g

borderCapColor

h

这些样式属性设置边框上的下列位置: