注意：在更高版本中可能会删除此类。

Spark 主题的外观使用 RichEditableText 类。这意味着，Spark TextArea 控件支持基于 Flash 文本引擎 (FTE) 的 Text Layout Framework (TLF) 库。组合后，可以在这些层上使用高质量的国际印刷效果和布局编辑文本。外观包括一个可以显示水平滚动条和垂直滚动条（用于滚动文本）的 Scroller，并支持使用鼠标滚轮垂直滚动。可以通过 textDisplay 形式访问 RichEditableText，通过 scroller 形式访问 Scroller。

Mobile 主题的外观使用 StyleableStageText 类。由于 StyleableStageText 使用本机文本字段，它可以在移动设备上实现更好的文本输入和操作体验，但您应该注意它有一些限制和差异。由于 StageText 不能度量文本，必须对 TextArea 给出显式、百分比形式或基于约束的 width 和 height。StyleableStageText 可以作为 textDisplay 访问。如果您希望使用基于 TextField 的外观而不是基于 StageText 的外观，请将 skinClass 属性设置为“spark.skins.mobile.TextAreaSkin”。

可以使用 text 属性设置要显示的文本或获取用户已输入的文本。

使用 CSS 样式（例如 fontFamily 和 fontSize）设置文本格式。

对于 Spark 主题，可以通过 widthInChars 和 heightInLines 属性以随字体大小缩放的方式指定 TextArea 的宽度和高度，也可以使用 typicalText 属性。请注意，如果使用 typicalText，则 widthInChars 和 heightInLines 属性将被忽略。对于所有主题，您也可以指定一个显式宽度或高度（以像素为单位），或者使用宽度和高度的百分比形式或约束，例如 left 和 right 或者 top 和 bottom。

可以使用 maxChars 属性限制用户可以输入的字符数，使用 restrict 限制用户可以输入的字符。要使用该控件输入密码，请将 displayAsPassword 属性设置为 true。

对于 Mobile 主题，特定于软键盘的属性 autoCapitalize、autoCorrect、returnKeyLabel 和 softKeyboardType 属性指定键盘提示。如果软键盘存在但它不支持提示表示的功能，则提示被忽略。在只有硬件键盘的移动环境中，这些提示将被忽略。

Spark 主题的文本区域

Spark TextArea 控件和 MX TextArea 控件之间的最重要区别如下所示：

• Spark TextArea 可提供更佳的印刷效果和文本布局，且能更好地支持各国语言。
• Spark TextArea 有面向对象模型的富文本，但 MX 版本却没有。
• 在显示大量文本时，Spark TextArea 性能表现得更好。
• Spark TextArea 嵌入字体的方式与 MX 版本不同。要了解如何在嵌入字体时使用 embedAsCFF 属性，请参阅“字体”文档。

Spark TextArea 控件使用 TLF 面向对象模型的富文本，其中，诸如分段、段落、范围、超链接和图像等文本布局元素在运行时由 ActionScript 对象表示。可以通过编程方式访问或操纵这些对象。TLF 中用于表示富文本的中心对象是 TextFlow。通过将 TextArea 控件的 textFlow 属性设置为 TextFlow 实例，来指定该控件的富文本。

如果不需要显示含有多种格式的文本，请将 TextArea 的 text 属性设置为纯文本字符串。有关 text 属性和 textFlow 属性如何进行交互（例如，可以设置一个属性，然后获取另一个属性）的信息，请参阅这两个属性的描述。

编译时，可以将 TLF 标记标签放在 TextArea 标签内，如下例所示：

  <s:TextArea>Hello <s:span fontWeight="bold">World!</s:span></s:TextArea>
  

TextArea 控件不包含任何用于更改文本格式的用户界面，但是包含可以用于以编程方式设置文本格式的 API。例如，可以创建一个按钮，当单击该按钮时，选定文本可变为粗体。

默认文本格式由 CSS 样式确定，例如 fontFamily 和 fontSize。TextFlow 对象中的任何格式信息都会覆盖 CSS 样式确定的默认格式。

可以使用样式控制 TextArea 内容的许多特征。以下是一些常用示例：

• 使用 lineHeight 样式控制行间距。
• 使用 paragraphSpaceBefore 和 paragraphSpaceAfter 样式控制段间距。
• 使用 textAlign 和 textAlignLast 样式将文本对齐或两端对齐。
• 使用 paddingLeft、paddingTop、paddingRight 和 paddingBottom 样式从控件的边框插入文本。

默认情况下，文本在控件的右边缘换行。如果文本超出了 TextArea 范围，会自动显示垂直滚动条。如果将 lineBreak 样式设置为 explicit，则仅在显式换行符处开始新行。如果在 text 中使用 CR (\r)、LF (\n) 或 CR+LF (\r\n)，或者在 TLF 标记中使用 <p> 和 <br/>，也会产生相同的效果。在这些情况下，如果任何文本行宽于控件，都会自动显示水平滚动条。

Spark TextArea 可以显示从左到右 (LTR) 书写的文本（如法语）、从右到左 (RTL) 书写的文本（如阿拉伯语）以及双向书写的文本（如阿拉伯语语句中的法语语句）。如果文本的主要书写方向为从右到左，请将 direction 样式设置为 rtl。textAlign 样式默认为 start，这样，当 direction 为 ltr 时，文本左对齐；当 direction 为 rtl 时，文本右对齐。要获得反向对齐，请将 textAlign 设置为 end。

Spark TextArea 还支持在一个编辑会话内执行无限次撤消/重做操作。编辑会话在控件获得键盘焦点时启动，在控件失去焦点时结束。

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

对于 Spark 主题，TextArea 控件具有以下默认特性：

对于 Mobile 主题，TextArea 控件具有以下默认特性：

Grid 组件旨在用作 DataGrid 外观部件或其它自定义组合组件的元素。因此，它的外观不可以设置，它不包含滚动条且不提供默认的鼠标或键盘事件处理。

每个可见 Grid 单元格都由使用 itemRenderer 属性创建的 GridItemRenderer 实例显示。为每列指定一个项呈示器。显示前，每个项呈示器实例会使用相应行的数据提供程序项的值进行配置。根据需要创建项呈示器，然后使创建开销保持最低值、能够共用和重复使用。

Grid 控件根据 selectionMode 属性支持选定内容。可使用选择方法（如 setSelectedIndex 或 selectionContainsIndex()）以编程方式修改或查询所选行或单元格的索引集。

Grid 控件基于 selectionMode 属性以及对应行索引和列索引属性（如 hoverRowIndex 和 columnRowIndex）显示悬停、插入标记和选定内容指示符。指示符可以是任何可视元素。实现 IGridVisualElement 的指示符可以根据在其中使用的行和列来对自身进行配置。

Grid 控件支持平滑滚动。其垂直和水平滚动位置定义网格的可视部件的像素原点，网格的布局仅根据需要显示尽可能多的单元格项呈示器来填充可用空间。

Grid 控件支持基于项呈示器的内容自动计算其高度的高度可变的行。此支持称为网格虚拟化，因为从（像素）滚动位置到行和列索引的映射通常基于有关网格单元格的首选大小的不完整信息。Grid 缓存已滚动到视图的计算的行高度并基于单个 typicalItem 估算其余值。

不支持 DataGrid 项呈示器中的转换。GridItemRenderer 类已禁用了其 transitions 属性，因此对此进行设置也无效。

Application 容器具有下列默认特征：

当用户选择 Button 控件时，该控件通常使用事件侦听器来执行操作。当用户在 Button 控件上单击鼠标时，就会启用 Button 控件，此控件分派 click 事件和 buttonDown 事件。无论按钮是处于启用状态还是禁用状态，总是会分派 mouseMove、mouseOver、mouseOut、rollOver、rollOut、mouseDown 和 mouseUp 等事件。

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

Button 控件具有下列默认特征：

用户单击 CheckBox 组件或其关联文本时，CheckBox 组件会将其 selected 属性设置为 true（表示选中）或 false（表示取消选中）。

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

CheckBox 控件具有下列默认特征：

为了改进性能和最小化应用程序大小，不能设置 Group 容器的外观。如果希望应用外观，请改用 SkinnableContainer。

注意：当 Group 内部存在 DisplayObject 子代（如组件或另一个 Group）时，刻度网格可能无法正常工作。如果子代是 GraphicElement 对象，并且全部共享该 Group 的 DisplayObject，则刻度网格将正常工作。

对 GraphicElement 子代设置下列任何属性要求 GraphicElement 创建其自己的 DisplayObject，从而使 Group 的刻度网格属性无效。

  alpha
  blendMode other than BlendMode.NORMAL or "auto"
  colorTransform
  filters
  mask
  matrix
  rotation
  scaling
  3D properties
  bounds outside the extent of the Group
  

Group 容器具有下列默认特征：

Spark 主题的 TextInput 外观使用 RichEditableText 类。这意味着 Spark TextInput 控件支持基于 Flash 文本引擎 (FTE) 的 Text Layout Framework (TLF) 库。组合后，可以在这些层上使用高质量的国际印刷效果和布局编辑文本。

Mobile 主题的 TextInput 外观使用 StyleableStageText 类而不是 RichEditableText。由于 StyleableStageText 使用本机文本字段，它可以在移动设备上实现更好的文本输入和操作体验，但您应该注意它有一些限制和差异。StageText 使用的本机文本控件对文本周围应用不同的填充。为了避免垂直滚动，基于 StageText 的 TextInput 外观尝试估计此填充并对其进行补偿。由于此问题以及本机文本控件在文本处理方式上的其他差异，使用基于 StageText 的 TextInput 控件外观的默认高度将不同于它在使用基于 TextField 的 TextInput 外观时的默认高度。

可以使用 text 属性设置要显示的文本或获取用户已输入的文本。该属性是一个 String，因此如果用户输入数值，例如，会将该数值报告为“123.45”，而不是 123.45。

使用 CSS 样式（例如 fontFamily 和 fontSize）设置文本格式。

对于 Spark 主题，您可以使用 widthInChars 属性（该属性可方便地通过随字体大小缩放来指定宽度）或 typicalText 属性指定控件的宽度。请注意，如果使用 typicalText，则 widthInChars 属性将被忽略。对于所有主题，您也可以指定一个显式宽度（以像素为单位或以宽度的百分比形式），或者使用约束，例如 left 和 right。通常情况下，不需要执行任何操作来指定高度；控件的默认高度足以能够显示一行文本。

可以使用 maxChars 属性限制用户可以输入的字符数，使用 restrict 限制用户可以输入的字符。要使用该控件输入密码，请将 displayAsPassword 属性设置为 true。

对于 Mobile 主题，特定于软键盘的属性 autoCapitalize、autoCorrect、returnKeyLabel 和 softKeyboardType 属性指定键盘提示。如果软键盘存在但它不支持提示表示的功能，则提示被忽略。在只有硬件键盘的移动环境中，这些提示将被忽略。

当用户按下 Enter 键，而不是插入换行符时，该控件分派 FlexEvent.ENTER 事件，因为该控件不支持输入多行文本。默认情况下，该控件具有显式换行符。

此控件是一个外观可变的控件，其默认外观包含 Spark 主题的一个 RichEditableText 实例或 Mobile 主题的一个 StyleableStageText 实例。它处理显示和编辑文本。（该外观还会处理绘制边框和背景。）此 RichEditableText 或 StyleableStageText 实例可以作为 textDisplay 对象进行访问。对于 Mobile 主题，如果您希望使用基于 TextField 的外观而不是基于 StageText 的外观，请将 skinClass 属性设置为“spark.skins.mobile.TextInputSkin”。

对于 Spark 主题，由于其 RichEditableText 使用 TLF，Spark TextInput 控件支持显示从左到右 (LTR) 的文本（如法语）和从右到左 (RTL) 的文本（如阿拉伯语）以及双向文本（如阿拉伯语内出现法语短语）。如果文本的主要书写方向为从右到左，请将 direction 样式设置为 rtl。textAlign 样式默认为 start，这样，当 direction 为 ltr 时，文本左对齐；当 direction 为 rtl 时，文本右对齐。要获得反向对齐，请将 textAlign 设置为 end。

此外，使用 TLF 后，Spark TextInput 还支持在一个编辑会话内执行无限次撤消/重做操作。编辑会话在控件获得键盘焦点时启动，在控件失去焦点时结束。

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

对于 Spark 主题，TextInput 控件具有以下默认特性：

对于 Mobile 主题，TextInput 控件具有以下默认特性：

下表描述了 Flex 中用于创建表单的组件：

NumericStepper 控件包括一个单行输入文本字段和一对用于逐一显示可能值的箭头按钮。还可使用向上箭头键和向下箭头键以及鼠标滑轮遍历这些值。当用户按 Enter 键，从组件删除焦点，或通过按箭头按钮或调用 changeValueByStep() 方法增减 NumericStepper 时，将提交输入值。

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

NumericStepper 控件具有下列默认特征：

Spinner 由两个必需按钮组成，一个用于增大当前值，一个用于减小当前值。用户还可使用向上箭头键和向下箭头键或鼠标滚轮遍历这些值。当用户按 Enter 键，从组件删除焦点，或通过按箭头按钮或调用 changeValueByStep() 方法增减 Spinner 时，将提交输入值。

Spinner 组件的范围是 value 属性的允许的值集。允许的值为 minimum 与 snapInterval 属性的整数倍数之和，且小于或等于 maximum 值。例如：

• minimum = -1
• maximum = 10
• snapInterval = 3

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

Spinner 控件具有下列默认特征：

组件可以更改它自己的尺寸（width 和 height）并相应地重新布局其子项（这是默认的调整大小模式）。

组件的另一个选项是更改其比例，在这种情况下子项根本不需要更改。Group 支持此选项。

不要在 MX 导航器容器外使用 NavigatorContent 容器。

NavigatorContent 容器的创建策略基于其父导航器容器的创建策略：

• 如果父代的创建策略为无，则 NavigatorContent 的创建策略也为无。
• 如果父代的创建策略为全部，则 NavigatorContent 的创建策略也为全部。
• 如果父代的创建策略为自动，则 NavigatorContent 的创建策略为无。

NavigatorContent 容器不支持排队的创建策略。

NavigatorContent 容器具有下列默认特征：

滑块可以允许最小值和最大值之间连续范围内的值，也可以限制为最小值和最大值之间具体间隔处的值。它可以使用数据提示显示其当前值。

VSlider 控件具备下列默认特征：

可以使用 selected 属性以编程方式获取或设置此状态。

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

ToggleButton 控件具有下列默认特征：

尽管可以使用 HScrollBar 控件作为独立控件，但通常将其结合作为另一组组件的一部分来提供滚动功能。

HScrollBar 控件具有下列默认特征：

不需要创建 SkinnablePopUpContainer 容器作为其父容器的正常布局。它会作为弹出窗口显示在其父代的顶部。因此，您不必在应用程序的 MXML 代码中直接创建它。

而应经常在单独的 MXML 文件中创建它作为 MXML 组件。要显示该组件，请先创建 MXML 组件的实例，然后调用 open() 方法。您还可以在打开组件时设置其大小和位置。

要关闭该组件，请调用 close() 方法。如果弹出窗口需要将数据传递回处理程序，您可以为 PopUp.CLOSE 事件添加事件侦听器，并在 close() 方法中指定返回数据。

SkinnablePopUpContainer 最初处于 closed 外观状态。打开它时，会作为弹出窗口添加到 PopUpManager，并过渡到 normal 外观状态。要定义打开和关闭动画，请在 closed 和 normal 外观状态之间配合使用自定义外观和过渡。

SkinnablePopUpContainer 容器具有下列默认特征：

DropDownList 控件由锚点按钮、提示区域和下拉列表组成，使用锚点按钮可打开和关闭下拉列表。提示区域显示一个提示 String，或者显示下拉列表中的选定项目。

打开下拉列表时：

• 单击锚点按钮会关闭下拉列表并提交当前选定的数据项目。
• 在下拉列表之外单击会关闭下拉列表并提交当前选定的数据项目。
• 在某个数据项目上单击会选中该项目并关闭下拉列表。
• 如果 requireSelection 属性为 false，则按下 Ctrl 键的同时单击某个数据项目会取消选中该项目并关闭下拉列表。

注意：基于 Spark List 的控件（Spark ListBase 类及其子类，如 ButtonBar、ComboBox、DropDownList、List 和 TabBar）不支持将 BasicLayout 类作为 layout 属性的值。不要将 BasicLayout 与基于 Spark List 的控件一起使用。

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

DropDownList 控件具有下列默认特征：