对 ComboBox 组件使用样式

您可以设置样式属性来更改 ComboBox 组件的外观。如果样式属性的名称以"Color"结尾，则它是颜色样式属性，并且行为与非颜色样式属性不同。有关详细信息，请参阅《使用 ActionScript 2.0 组件》中的"使用样式自定义组件的颜色和文本"。

组合框有两种独特样式：openDuration 和 openEasing。其它样式通过各自组件传递到组合框的按钮、文本框和下拉列表，如下所示：

该按钮是一个 Button 实例，并使用它自己的样式。（请参阅"对 Button 组件使用样式"。）

文本是一个 TextInput 实例，它使用自己的样式。（请参阅"对 TextInput 组件使用样式"。）

下拉列表是一个 List 实例并使用它自己的样式。（请参阅"对 List 组件使用样式"。）

ComboBox 组件使用下列样式：

样式	主题	描述
`themeColor`	光晕	组件的基本配色方案。可能的值包括 `"haloGreen"`、`"haloBlue"` 和 `"haloOrange"`。默认值为 `"haloGreen"`。
`backgroundColor`	光晕和范例	背景色。默认颜色为白色。
`borderStyle`	光晕和范例	Button 子组件将两个 RectBorder 实例用作其边框，并对在该类上定义的样式做出响应。请参阅"RectBorder 类"。在"光晕"主题中，ComboBox 组件将一个自定义圆角边框用于 ComboBox 的折叠部分。此部分 ComboBox 的颜色只能通过外观进行修改。请参阅对 ComboBox 组件使用外观。
`color`	光晕和范例	文本颜色。"光晕"主题的默认值为 0x0B333C，"范例"主题的默认值为空白。
`disabledColor`	光晕和范例	组件禁用时的文本颜色。默认值为 0x848384（深灰）。
`embedFonts`	光晕和范例	一个布尔值，指示在 `fontFamily` 中指定的字体是否为嵌入字体。如果 `fontFamily` 引用了嵌入字体，则此样式必须设置为 `true`。否则，将不使用该嵌入字体。如果此样式设置为 `true`，并且 `fontFamily` 不引用嵌入字体，则不会显示任何文本。默认值为 `false`。
`fontFamily`	光晕和范例	文本的字体名称。默认值为 `"_sans"`。
`fontSize`	光晕和范例	字体的磅值。默认值为 10。
`fontStyle`	光晕和范例	字体样式：`"normal"` 或 `"italic"`。默认值为 `"normal"`。
`fontWeight`	光晕和范例	字体粗细：`"none"` 或 `"bold"`。默认值为 `"none"`。在调用 `setStyle()` 期间，所有组件还可以接受值 `"normal"` 来代替 `"none"`，但随后对 `getStyle()` 的调用将返回 `"none"`。
`textAlign`	光晕和范例	文本对齐方式：`"left"`、`"right"` 或 `"center"`。默认值为 `"left"`。
`textDecoration`	光晕和范例	文本修饰：`"none"` 或 `"underline"`。默认值为 `"none"`。
`openDuration`	光晕和范例	过渡动画的持续时间（以毫秒为单位）。默认值为 250。
`openEasing`	光晕和范例	对控制动画的补间函数的引用。默认为正弦输入/输出。有关详细信息，请参阅《使用 ActionScript 2.0 组件》中的"自定义组件动画"。

样式

主题

描述

themeColor

光晕

组件的基本配色方案。可能的值包括 "haloGreen"、"haloBlue" 和 "haloOrange"。默认值为 "haloGreen"。

backgroundColor

光晕和范例

背景色。默认颜色为白色。

borderStyle

光晕和范例

Button 子组件将两个 RectBorder 实例用作其边框，并对在该类上定义的样式做出响应。请参阅"RectBorder 类"。

在"光晕"主题中，ComboBox 组件将一个自定义圆角边框用于 ComboBox 的折叠部分。此部分 ComboBox 的颜色只能通过外观进行修改。请参阅对 ComboBox 组件使用外观。

color

光晕和范例

文本颜色。"光晕"主题的默认值为 0x0B333C，"范例"主题的默认值为空白。

disabledColor

光晕和范例

组件禁用时的文本颜色。默认值为 0x848384（深灰）。

embedFonts

光晕和范例

一个布尔值，指示在 fontFamily 中指定的字体是否为嵌入字体。如果 fontFamily 引用了嵌入字体，则此样式必须设置为 true。否则，将不使用该嵌入字体。如果此样式设置为 true，并且 fontFamily 不引用嵌入字体，则不会显示任何文本。默认值为 false。

fontFamily

光晕和范例

文本的字体名称。默认值为 "_sans"。

fontSize

光晕和范例

字体的磅值。默认值为 10。

fontStyle

光晕和范例

字体样式："normal" 或 "italic"。默认值为 "normal"。

fontWeight

光晕和范例

字体粗细："none" 或 "bold"。默认值为 "none"。在调用 setStyle() 期间，所有组件还可以接受值 "normal" 来代替 "none"，但随后对 getStyle() 的调用将返回 "none"。

textAlign

光晕和范例

文本对齐方式："left"、"right" 或 "center"。默认值为 "left"。

textDecoration

光晕和范例

文本修饰："none" 或 "underline"。默认值为 "none"。

openDuration

光晕和范例

过渡动画的持续时间（以毫秒为单位）。默认值为 250。

openEasing

光晕和范例

对控制动画的补间函数的引用。默认为正弦输入/输出。有关详细信息，请参阅《使用 ActionScript 2.0 组件》中的"自定义组件动画"。

以下示例演示如何使用 List 样式来控制 ComboBox 组件的下拉列表部分的行为。

// comboBox 为舞台上的 ComboBox 组件的一个实例。
comboBox.setStyle("alternatingRowColors", [0xFFFFFF, 0xBFBFBF]);