对 Alert 组件使用样式

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

Alert 组件支持下列样式：

样式	主题	描述
`themeColor`	光晕	组件的基本配色方案。可能的值包括 `"haloGreen"`、`"haloBlue"` 和 `"haloOrange"`。默认值为 `"haloGreen"`。
`backgroundColor`	光晕和范例	背景色。"光晕"主题的默认颜色为白色，"范例"主题的默认颜色为 0xEFEBEF（浅灰）。
`borderStyle`	光晕和范例	Alert 组件使用 RectBorder 实例作为其边框并对在该类上定义的样式做出响应。有关详细信息，请参阅"RectBorder 类"。 Alert 组件具有一个特定于组件的 `borderStyle` 设置，该设置在"光晕"主题中为`"alert"`，在"范例"主题中为`"outset"`。
`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"`。
`textIndent`	光晕和范例	表示文本缩进的数字。默认值为 0。

样式

主题

描述

themeColor

光晕

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

backgroundColor

光晕和范例

背景色。"光晕"主题的默认颜色为白色，"范例"主题的默认颜色为 0xEFEBEF（浅灰）。

borderStyle

光晕和范例

Alert 组件使用 RectBorder 实例作为其边框并对在该类上定义的样式做出响应。有关详细信息，请参阅"RectBorder 类"。

Alert 组件具有一个特定于组件的 borderStyle 设置，该设置在"光晕"主题中为"alert"，在"范例"主题中为"outset"。

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"。

textIndent

光晕和范例

表示文本缩进的数字。默认值为 0。

Alert 组件包含三种不同的文本类别。设置 Alert 组件自身的文本属性会为所有这三种类别提供默认值，如下所示：

import mx.controls.Alert;
_global.styles.Alert.setStyle("color", 0x000099);
Alert.show("This is a test alert", "Title");

Alert 组件提供静态属性（对 CSSStyleDeclaration 实例的引用）用以单独设置一个类别的文本样式。

静态属性	影响的文本
`buttonStyleDeclaration`	按钮
`messageStyleDeclaration`	消息
`titleStyleDeclaration`	标题

静态属性

影响的文本

buttonStyleDeclaration

按钮

messageStyleDeclaration

消息

titleStyleDeclaration

标题

以下示例演示如何将 Alert 组件的标题设置为斜体：

import mx.controls.Alert;
import mx.styles.CSSStyleDeclaration;

var titleStyles = new CSSStyleDeclaration();
titleStyles.setStyle("fontWeight", "bold");
titleStyles.setStyle("fontStyle", "italic");

Alert.titleStyleDeclaration = titleStyles;

Alert.show("Name is a required field", "Validation Error");

默认的标题样式声明将 fontWeight 设置为 "bold"。覆盖 titleStyleDeclaration 属性时，此默认设置也被覆盖。因此如果需要此设置，必须将 fontWeight 显式设置为 "bold"。

注意

在 Alert 组件上设置的文本样式通过样式继承为其组件提供默认的文本样式。有关详细信息，请参阅《使用 ActionScript 2.0 组件》中的"设置容器上的继承样式"。