在显示编辑器的同时更改这些值对当前编辑器没有任何影响，但会影响下一个打开编辑器的项呈示器。

在显示编辑器的同时更改此值对当前编辑器没有任何影响，但会影响下一个打开编辑器的项呈示器。

在显示编辑器的同时更改这些值对当前编辑器没有任何影响，但会影响下一个打开编辑器的项呈示器。

在显示编辑器的同时更改这些值对当前编辑器没有任何影响，但会影响下一个打开编辑器的项呈示器。

在显示编辑器的同时更改这些值对当前编辑器没有任何影响，但会影响下一个打开编辑器的项呈示器。

若要在编辑项目时访问项目编辑器实例和新项目值，则应使用 itemEditorInstance 属性。只有在执行 itemEditBegin 事件的事件侦听器之后，itemEditorInstance 属性才有效。因此，您通常只从 itemEditEnd 事件的事件侦听器中访问 itemEditorInstance 属性。

itemEditor 属性定义项目编辑器的类，从而定义项目编辑器实例的数据类型。

不要以 MXML 方式设置此属性。

此 Object 包含 columnIndex 和 rowIndex 这两个字段，分别是项目的从零开始的列索引和项目索引。对于 List 控件，columnIndex 属性始终为 0；例如：{columnIndex:0, rowIndex:3}。

设置此属性会将项目滚动到视图中，并会分派 itemEditBegin 事件以打开指定项目上的项目编辑器。

在 itemEditBegin 和 itemEditEnd 事件的事件侦听器中，您可以使用 editedItemRenderer.data 属性访问所编辑的项目的当前值。

flash.system.IMEConversionMode 类定义此属性的有效值的常量。您还可以指定 null 不指定任何 IME 模式。

condenseWhite 属性只影响使用 htmlText 属性（而非 text 属性）设置的文本。如果使用 text 属性设置文本，则忽略 condenseWhite。

如果将 condenseWhite 属性设置为 true，则必须使用标准 HTML 命令（如 <br> 和 <p>）将换行符放在文本字段中。

将控件用作嵌入式项呈示器或嵌入式项目编辑器时，Flex 自动将项目的当前值写入此控件的 text 属性。

不要以 MXML 方式设置此属性。

如果设置了此属性，则会在应用 TextArea 实例的 CSS 样式后应用 HTML 标记。获取此属性时，HTML 标记包括 CSS 样式。

例如，如果将此属性设置为 "This is an example of <b>bold</b> markup" 之类的字符串，则文本“This is an example of bold markup”将以通常应用的 CSS 样式在 TextArea 中进行显示。此外，由于存在 <b> 标记，“bold”一词将显示为粗体。

HTML 标记使用 < and > 等字符，这些字符在 XML 中具有特殊意义（在 MXML 中也同样如此）。所以，以下代码不能编译：

      <mx:TextArea htmlText="This is an example of <b>bold</b> markup"/>
      

有三种方法可以解决此问题。

• 在作为 initialize 处理函数调用的 ActionScript 方法中设置 htmlText 属性：

        <mx:TextArea id="myTextArea" initialize="myTextArea_initialize()"/>
        

  其中 myTextArea_initialize 方法位于脚本 CDATA 节：

        <fx:Script>
        <![CDATA[
        private function myTextArea_initialize():void {
            myTextArea.htmlText = "This is an example of <b>bold</b> markup";
        }
        ]]>
        </fx:Script>
        
        

  由于 HTML 标记依然简单易读，因此这是最简单的方法。请注意，必须为 TextArea 分配一个 id，以便在 initialize 处理函数中引用它。

• 使用带有 CDATA 节的子标签指定 htmlText 属性。XML 中的 CDATA 节包含字符数据，其中 < 和 > 等字符不具有特殊意义。

        <mx:TextArea>
            <mx:htmlText><![CDATA[This is an example of <b>bold</b> markup]]></mx:htmlText>
        <mx:TextArea/>
        

  您必须将 htmlText 属性编写为子标签，而不是 <mx:TextArea> 标签上的某一属性，因为 XML 不允许属性值中含有 CDATA。请注意，该标记可读性依然很好，但由于涉及到 CDATA 节，该方法比较复杂。

• 使用 hmtlText 属性，其中只要是 HTML 标记字符 < 和 >，就会在属性值中将其写成 XML“实体”&lt; 和 &gt;：

        <mx:TextArea htmlText="This is an example of &lt;b&gt;bold&lt;/b&gt; markup"/&gt;
        

  由于使用此方法时 HTML 标记的可读性很差，因此 Adobe 不建议使用此方法。

设置 htmlText 属性时，如果 condenseWhite 属性为 true，将压缩多个空白字符（与基于 HTML 的浏览器中的情况类似），例如，三个连续的空格显示为一个空格。condenseWhite 的默认值为 false，因此，若要压缩空白字符，必须将 condenseWhite 设置为 true。

如果设置 htmlText 属性后立即重新读取该属性，将会看到设置的字符串。但是，如果 LayoutManager 开始运行，该值将发生更改，以包括包含 CSS 样式的其他标记。

设置 htmlText 属性将影响 text 属性的多个方面。如果设置 htmlText 属性后立即读取 text 属性，则您将收到 null，这表明尚未确定与新的 htmlText 相对应的 text。但是，在运行 LayoutManager 后，text 属性值将更改为删除了所有 HTML 标记的 htmlText 字符串，即此值为 TextArea 实际显示的字符。

反之，如果设置 text 属性，则先前设置的任何 htmlText 都将是不相关的。如果设置 text 属性后立即读取 htmlText 属性，则您将收到 null，这表明尚未确定与新的 text 相对应的 htmlText。但是，如果 LayoutManager 开始运行，htmlText 属性值更改为新的文本以及 CSS 样式的 HTML 标记。

若要使 LayoutManager 立即运行，您可以调用 TextArea 的 validateNow() 方法。例如，您可以设置一些 htmlText，调用 validateNow() 方法，然后立即获得相应的不包含 HTML 标记的 text。

如果在 ActionScript 中设置 text 和 htmlText 两种属性，则最后设置的属性会生效。切勿在 MXML 中同时设置这两种属性，因为 MXML 不保证能够以特定顺序对实例的属性进行设置。

在某个循环内设置 text 或 htmlText 属性的操作完成得很快，因为实际呈示文本的基础 TextField 在 LayoutManager 运行后才更新。

如果尝试将此属性设置为 null，则该属性将设置为空字符串。如果属性值暂时为 null，则表明刚刚设置了 text，但尚未确定相应的 htmlText。

flash.system.IMEConversionMode 类定义此属性的有效值的常量。您还可以指定 null 不指定任何 IME 模式。

您无需在 MXML 或 ActionScript 中设置此属性；将组件用作嵌入式项呈示器或嵌入式项目编辑器时，Flex 会对其进行设置。

默认值为 0，表示无限制。

Flex 按从左到右的顺序浏览字符串。可以使用连字符 (-) 指定一个范围。如果字符串以尖号 (^) 开头，则先接受所有字符，然后从接受字符集中排除字符串中 ^ 之后的字符。如果字符串不以尖号 (^) 开头，则最初不接受任何字符，然后将字符串中的字符包括在接受字符集中。

由于某些字符在 restrict 属性中使用时具有特殊的意义，因此必须使用反斜杠字符指定文本字符 -、^ 和 \。将 restrict 属性用作 MXML 标签中的属性时，请使用单一反斜杠，如下例所示：\^\-\\。当您在 ActionScript 表达式中设置 restrict 时，请使用两个反斜杠，如下例所示：\\^\\-\\\。

只有在组件经过验证后，textHeight 属性的值才是正确的。如果您在设置 text 后立即请求 textHeight，则接收到的值可能不正确。您应等待组件经过验证或调用 validateNow() 方法后，再获取此值。此行为与 flash.text.TextField 控件有所不同，后者会立即更新此值。

只有在组件经过验证后，textWidth 属性的值才是正确的。如果您在设置 text 后立即请求 textWidth，则接收到的值可能不正确。您应等待组件经过验证或调用 validateNow() 方法后，再获取此值。此行为与 flash.text.TextField 控件有所不同，后者会立即更新此值。

文本字符串中的任何 HTML 标签都将被忽略，其显示效果就像以字符串形式输入的一样。要显示使用 HTML 标签进行格式设置的文本，请改用 htmlText 属性。如果设置了 htmlText 属性，则 HTML 将替换使用此属性设置的所有文本，并且 text 属性将返回 HTML 文本的纯文本版本，而从中去除了所有 HTML 标签。有关详细信息，请参阅 htmlText 属性。

要在文本中包括特殊字符左尖括号 (<)、右尖括号 (>) 或和号 (&)，请将文本字符串包含在 CDATA 标签中。此外，您可以使用 HTML 字符实体表示特殊字符，例如 &lt;。

如果尝试将此属性设置为 null，则该属性将设置为空字符串。text 属性可暂时使用值 null，此值表示刚刚设置了 htmlText 值，但相应的 text 值尚未确定。

如果您使用其他标签，则可能需要调整 buttonWidth 属性以显示其完整内容。

如果您使用其他标签，则可能需要调整 buttonWidth 属性以显示其完整内容。

如果您使用其他标签，则可能需要调整 buttonWidth 属性以显示其完整内容。

如果您使用其他标签，则可能需要调整 buttonWidth 属性以显示其完整内容。

在 ActionScript 中，可以使用以下常量来设置此属性：ProgressBarDirection.RIGHT 和 ProgressBarDirection.LEFT。

在 ActionScript 中，可以使用以下常量来设置此属性：ProgressBarLabelPlacement.RIGHT、ProgressBarLabelPlacement.LEFT、ProgressBarLabelPlacement.BOTTOM、ProgressBarLabelPlacement.CENTER 和 ProgressBarLabelPlacement.TOP。

• %1 = 当前加载的字节数
• %2 = 总字节数
• %3 = 已加载的百分比数
• %% =“%”字符

如果某个域未知，则用“??”替换。如果尚未定义，则不显示此标签。

如果处于手动模式，则可以使用 setProgress() 方法设置这些特殊字符的值。

• event 由 source 属性指定的控件必须分派进度事件和已完成的事件。ProgressBar 控件使用这些事件更新其状态。仅当 source 属性的值扩展 EventDispatcher 类时，ProgressBar 控件才会更新。
• polled source 属性必须指定一个公开 bytesLoaded 和 bytesTotal 属性的对象。ProgressBar 控件调用这些方法更新其状态。
• manual 手动更新 ProgressBar 状态。在此模式中，需指定 maximum 和 minimum 属性，并使用 setProgress() 属性方法指定状态。此模式通常在将 indeterminate 属性设为 true 时使用。

在 ActionScript 中，可以使用以下常量来设置此属性：ProgressBarMode.EVENT、ProgressBarMode.POLLED 和 ProgressBarMode.MANUAL。

condenseWhite 属性仅会对使用 htmlText 属性设置的文本产生影响，而不会对使用 text 属性设置的文本产生影响。如果使用 text 属性设置文本，则忽略 condenseWhite。

如果将 condenseWhite 属性设置为 true，您必须使用标准 HTML 命令（如 <br> 和 <p>）在文本字段中放置换行符。

将控件用作嵌入式项呈示器或嵌入式项目编辑器时，Flex 自动将项目的当前值写入此控件的 text 属性。

不要以 MXML 方式设置此属性。

如果设置了此属性，则会在应用 Label 实例的 CSS 样式后应用 HTML 标记。获取此属性时，HTML 标记包括 CSS 样式。

例如，如果将此属性设置为 "This is an example of <b>bold</b> markup" 之类的字符串，则文本“This is an example of bold markup”将以通常应用的 CSS 样式在 Label 中进行显示。此外，由于存在 <b> 标记，“bold”一词将显示为粗体。

HTML 标记使用 < and > 等字符，这些字符在 XML 中具有特殊意义（在 MXML 中也同样如此）。所以，以下代码不能编译：

      <mx:Label htmlText="This is an example of <b>bold</b> markup"/>
      

有三种方法可以解决此问题。

• 在作为 initialize 处理函数调用的 ActionScript 方法中设置 htmlText 属性：

        <mx:Label id="myLabel" initialize="myLabel_initialize()"/>
        

  其中 myLabel_initialize 方法位于脚本 CDATA 节：

        <fx:Script>
        <![CDATA[
        private function myLabel_initialize():void {
            myLabel.htmlText = "This is an example of <b>bold</b> markup";
        }
        ]]>
        </fx:Script>
        
        

  由于 HTML 标记依然简单易读，因此这是最简单的方法。请注意，必须为标签分配 id，以便在 initialize 处理函数中引用它。

• 使用带有 CDATA 节的子标签指定 htmlText 属性。XML 中的 CDATA 节包含字符数据，其中 < 和 > 等字符不具有特殊意义。

        <mx:Label>
            <mx:htmlText><![CDATA[This is an example of <b>bold</b> markup]]></mx:htmlText>
        <mx:Label/>
        

  您必须将 htmlText 属性编写为子标签，而不是 <mx:Label> 标签上的某一属性，因为 XML 不允许属性值中含有 CDATA。请注意，该标记可读性依然很好，但由于涉及到 CDATA 节，该方法比较复杂。

• 使用 hmtlText 属性，其中只要是 HTML 标记字符 < 和 >，在属性值中就会显示为 XML“实体”&lt; 和 &gt;：

        <mx:Label htmlText="This is an example of &lt;b&gt;bold&lt;/b&gt; markup"/&gt;
        

  由于使用此方法时 HTML 标记的可读性很差，因此 Adobe 不建议使用此方法。

设置 htmlText 属性时，如果 condenseWhite 属性为 true，将压缩多个空白字符（与基于 HTML 的浏览器中的情况类似），例如，三个连续的空格显示为一个空格。condenseWhite 的默认值为 false，因此，若要压缩空白字符，必须将 condenseWhite 设置为 true。

如果设置 htmlText 属性后立即重新读取该属性，将会看到设置的字符串。但是，如果 LayoutManager 开始运行，该值将发生更改，以包括包含 CSS 样式的其他标记。

设置 htmlText 属性将影响 text 属性的多个方面。如果设置 htmlText 属性后立即读取 text 属性，则您将收到 null，这表明尚未确定与新的 htmlText 相对应的 text。但是，LayoutManager 运行后，text 属性值将更改为 htmlText 字符串，且所有 HTML 标签已删除；也就是说此值为 Label 实际显示的字符。

反之，如果设置 text 属性，则先前设置的任何 htmlText 都将是不相关的。如果设置 text 属性后立即读取 htmlText 属性，则您将收到 null，这表明尚未确定与新的 text 相对应的 htmlText。但是，如果 LayoutManager 开始运行，htmlText 属性值更改为新的文本以及 CSS 样式的 HTML 标记。

要使 LayoutManager 立即运行，您可以对 Label 调用 validateNow() 方法。例如，您可以设置一些 htmlText，调用 validateNow() 方法，然后立即获得相应的不包含 HTML 标记的 text。

如果在 ActionScript 中设置 text 和 htmlText 两种属性，则最后设置的属性会生效。切勿在 MXML 中同时设置这两种属性，因为 MXML 不保证能够以特定顺序对实例的属性进行设置。

在某个循环内设置 text 或 htmlText 属性的操作完成得很快，因为实际呈示文本的基础 TextField 在 LayoutManager 运行后才更新。

如果尝试将此属性设置为 null，则该属性将设置为空字符串。如果属性值暂时为 null，则表明刚刚设置了 text，但尚未确定相应的 htmlText。

您无需在 MXML 或 ActionScript 中设置此属性；将组件用作嵌入式项呈示器或嵌入式项目编辑器时，Flex 会对其进行设置。

在 Label 控件中指定 link 事件后，必须将 selectable 属性设置为 true 才能执行 link 事件。

只有在组件经过验证后，textHeight 属性的值才是正确的。如果您在设置 text 后立即请求 textHeight，则接收到的值可能不正确。您应等待组件经过验证或调用 validateNow() 方法后，再获取此值。此行为与 flash.text.TextField 控件有所不同，后者会立即更新此值。

只有在组件经过验证后，textWidth 属性的值才是正确的。如果您在设置 text 后立即请求 textWidth，则接收到的值可能不正确。您应等待组件经过验证或调用 validateNow() 方法后，再获取此值。此行为与 flash.text.TextField 控件有所不同，后者会立即更新此值。

当您设置此属性时，字符串中与 HTML 标记类似的字符没有任何特殊含义，将与输入时的显示一样。

要显示使用 HTML 标签格式化的文本，请改用 htmlText 属性。如果设置了 htmlText 属性，HTML 将替换使用此属性设置的所有文本，并且 text 属性将返回 HTML 文本的纯文本版本，而从中去除了所有 HTML 标签。

要在文本中包括特殊字符左尖括号 (<)、右尖括号 (>) 或和号 (&)，请将文本字符串包含在 CDATA 标签中。此外，您可以使用 HTML 字符实体表示特殊字符，例如 &lt;。

如果此文本比 Label 控件宽，则将由省略号 (...) 截断并终止。当您将鼠标移动到 Label 控件上时，整个文本将作为工具提示显示。如果您也使用 tooltip 属性设置了工具提示，则显示工具提示而不显示文本。

如果尝试将此属性设置为 null，则该属性将设置为空字符串。text 属性可暂时使用值 null，此值表示刚刚设置了 htmlText 值，但相应的 text 值尚未确定。

Button 子类（如 SliderThumb 和 ScrollThumb 类或 ScrollBar 的向上和向下箭头）将此属性设置为 true。

当您使用此控件作为嵌入式项呈示器或嵌入式项目编辑器时，Flex 会自动将此项目的当前值写入此控件的 selected 属性。

不要以 MXML 方式设置此属性。

在 ActionScript 中，您可以使用下列常量来设置此属性：ButtonLabelPlacement.RIGHT、ButtonLabelPlacement.LEFT、ButtonLabelPlacement.BOTTOM 和 ButtonLabelPlacement.TOP。

如果标签宽于 Button 控件，则截断此标签并使用省略号 (...) 终止。当用户将鼠标移至 Button 控件位置时，将显示完整标签作为工具提示。如果您还使用 tooltip 属性设置了工具提示，则显示工具提示而不是标签文本。

您无需在 MXML 或 ActionScript 中设置此属性；将组件用作嵌入式项呈示器或嵌入式项目编辑器时，Flex 会对其进行设置。

对于 CheckBox 控件，指示框中是否显示了复选标记。对于 RadioButton 控件，指示是否已选中该控件。

用户可以通过单击控件来更改此属性，但也可通过编程方式来设置此属性。

在早期版本中，如果将 toggle 属性设置为 true，则更改此属性还会分派 change 事件。从 3.0 版开始，以编程方式设置此属性仅分派 valueCommit 事件。

如果 dataProvider 对象不包含颜色字段，则将 colorField 属性设置为使用正确的字段名称。如果 dataProvider 是十六进制颜色值的 Array，则即使此属性可用，也不会有任何意义。

如果 dataProvider 对象不包含标签字段，则将 labelField 属性设置为使用正确的字段名称。如果 dataProvider 是十六进制颜色值的 Array，则即使此属性可用，也不会有任何意义。

当您使用此控件作为嵌入式项呈示器或嵌入式项目编辑器时，Flex 会自动将项目的当前值写入此控件的 selectedDate 属性。

此属性接受对象 Array 作为参数。此 Array 中的所有对象都是 Date 对象，用于指定要禁用的各个日期；也可以是包含 rangeStart 和（或）rangeEnd 属性的对象，它们的每个值都是 Date 对象。这些属性的值描述了日期范围的边界。如果忽略其中任一属性，则认为在该方向上无范围限制。如果仅指定 rangeStart，则将禁用指定日期之后的所有日期（包括 rangeStart 日期）。如果仅指定 rangeEnd，则将禁用指定日期之前的所有日期（包括 rangeEnd 日期）。要禁用某一日期，请使用一个 Date 对象指定 Array 中的某个日期。时间值（如果存在）将以 Date 对象为零值，依次递增。

以下示例将禁用下列日期：2006 年 1 月 11 日，从 2006 年 1 月 23 至同年 2 月 10 日，以及 2006 年 3 月 1 日及后续所有日期。

disabledRanges="{[new Date(2006,0,11), {rangeStart:
      new Date(2006,0,23), rangeEnd: new Date(2006,1,10)},
      {rangeStart: new Date(2006,2,1)}]}"

如果 displayedMonth 和 displayedYear 属性中包含禁用的日期，则设置此属性将立即更改 DateChooser 控件的外观。

默认值为当前月份。

默认值为当前年份。

该函数采用 Date 对象作为参数，并以要显示的格式返回一个字符串，如下例所示：

      public function formatDate(currentDate:Date):String {
          ...
          return dateString;
      }

如果允许用户在 DateField 控件的文本字段中输入日期，并且使用 labelFunction 属性定义格式化函数，则应为 parseFunction 属性指定一个函数将输入文本字符串转换为 Date 对象以供 DateField 控件使用，或者将 parseFunction 属性设置为 null。

您无需在 MXML 或 ActionScript 中设置此属性；将组件用作嵌入式项呈示器或嵌入式项目编辑器时，Flex 会对其进行设置。

此函数采用两个参数，并向 DateField 控件返回一个数据对象，如下例所示：

      public function parseDate(valueString:String, inputFormat:String):Date {
          ...
          return newDate
      }

其中，valueString 参数包含用户在文本字段中输入的文本字符串，而 inputFormat 参数包含字符串的格式。例如，如果只允许用户使用两个字符输入文本字符串表示月份、日期和年份，然后将“MM/DD/YY”传递给 inputFormat 参数。

此属性接受 Object 作为参数。该 Object 包含 Date 类型的两个属性：rangeStart 和 rangeEnd。如果仅指定了 rangeStart，则在此指定日期之后的所有日期都可用。如果仅指定了 rangeEnd，则在此指定日期之前的所有日期都可用。要仅在 DateChooser 控件中使用一个日期，可以直接传递一个 Date 对象。时间值（如果存在）将以 Date 对象为零值，依次递增。

以下示例仅启用 2006 年 1 月 1 日到 2006 年 6 月 30 日的范围。1 月之前和 6 月之后的月份不会出现在 DateChooser 中。

selectableRange="{{rangeStart : new Date(2006,0,1),
      rangeEnd : new Date(2006,5,30)}}"

选择当前选定日期时按住 Ctrl 键可取消对该日期的选择，将 selectedDate 属性设置为 null，然后分派 change 事件。

在 ActionScript 中，可使用以下常量来设置此属性：ButtonLabelPlacement.RIGHT、ButtonLabelPlacement.LEFT、ButtonLabelPlacement.BOTTOM 和 ButtonLabelPlacement.TOP。

当使用 ViewStack 容器时，ViewStack 容器子项的 label 和 icon 属性用于填充导航项目，如以下示例所示：

      <mx:LinkBar dataProvider="{vs}"/>
      <mx:ViewStack id="vs">
        <mx:VBox label="Accounts" icon="account_icon"/>
        <mx:VBox label="Leads" icon="leads_icon"/>
      </mx:ViewStack> 

LinkBar 控件包含两个链接：“Accounts”和“Leads”，每个链接都有各自的图标，这些图标在 VBox 标签上指定。单击某个链接时，ViewStack 容器就会导航到相应的视图。

使用 Array 时，labelField 属性可确定 dataProvider 字段的名称，这些字段将用作各个导航项目的标签；iconField 属性可确定 dataProvider 字段的名称，这些字段将用作各个导航项目的图标。如果使用字符串的 Array，则会忽略 labelField 属性。

您可以提供一个 labelFunction，用于查找合适的字段并返回可显示的字符串。labelFunction 还非常适用于处理格式设置和本地化。

对于大多数组件而言，此标签函数仅使用数据提供程序中的某个项目作为唯一参数，并返回一个 String。

      myLabelFunction(item:Object):String

默认值为 0。值为 -1 时将取消对该栏中所有按钮的选择。

condenseWhite 属性仅会对使用 htmlText 属性设置的文本产生影响，而不会对使用 text 属性设置的文本产生影响。如果使用 text 属性设置文本，则忽略 condenseWhite。

如果将 condenseWhite 属性设置为 true，您必须使用标准 HTML 命令（如 <br> 和 <p>）在文本字段中放置换行符。

将控件用作嵌入式项呈示器或嵌入式项目编辑器时，Flex 自动将项目的当前值写入此控件的 text 属性。

不要以 MXML 方式设置此属性。

设置此属性时，会在应用 TextInput 实例的 CSS 样式后应用 HTML 标记。获取此属性时，HTML 标记包括 CSS 样式。

例如，如果将此属性设置为 "This is an example of <b>bold</b> markup" 之类的字符串，则文本“This is an example of bold markup”将以通常应用的 CSS 样式在 TextInput 中进行显示。此外，由于存在 <b> 标记，“bold”一词将显示为粗体。

HTML 标记使用 < and > 等字符，这些字符在 XML 中具有特殊意义（在 MXML 中也同样如此）。所以，以下代码不能编译：

      <mx:TextInput htmlText="This is an example of <b>bold</b> markup"/>
      

有三种方法可以解决此问题。

• 在作为 initialize 处理函数调用的 ActionScript 方法中设置 htmlText 属性：

        <mx:TextInput id="myTextInput" initialize="myTextInput_initialize()"/>
        

  其中 myTextInput_initialize 方法位于脚本 CDATA 节：

        <fx:Script>
        <![CDATA[
        private function myTextInput_initialize():void {
            myTextInput.htmlText = "This is an example of <b>bold</b> markup";
        }
        ]]>
        </fx:Script>
        
        

  由于 HTML 标记依然简单易读，因此这是最简单的方法。请注意，必须为 TextInput 分配 id，以便在 initialize 处理函数中引用它。

• 使用带有 CDATA 节的子标签指定 htmlText 属性。XML 中的 CDATA 节包含字符数据，其中 < 和 > 等字符不具有特殊意义。

        <mx:TextInput>
            <mx:htmlText><![CDATA[This is an example of <b>bold</b> markup]]></mx:htmlText>
        <mx:TextInput/>
        

  您必须将 htmlText 属性编写为子标签，而不是 <mx:TextInput> 标签上的某一属性，因为 XML 不允许属性值中含有 CDATA。请注意，该标记可读性依然很好，但由于涉及到 CDATA 节，该方法比较复杂。

• 使用 hmtlText 属性，其中只要是 HTML 标记字符 < 和 >，在属性值中就会显示为 XML“实体”&lt; 和 &gt;：

        <mx:TextInput htmlText="This is an example of &lt;b&gt;bold&lt;/b&gt; markup"/&gt;
        

  由于使用此方法时 HTML 标记的可读性很差，因此 Adobe 不建议使用此方法。

设置 htmlText 属性时，如果 condenseWhite 属性为 true，将压缩多个空白字符（与基于 HTML 的浏览器中的情况类似），例如，三个连续的空格显示为一个空格。condenseWhite 的默认值为 false，因此，若要压缩空白字符，必须将 condenseWhite 设置为 true。

如果设置 htmlText 属性后立即重新读取该属性，将会看到设置的字符串。但是，如果 LayoutManager 开始运行，该值将发生更改，以包括包含 CSS 样式的其他标记。

设置 htmlText 属性将影响 text 属性的多个方面。如果设置 htmlText 属性后立即读取 text 属性，则您将收到 null，这表明尚未确定与新的 htmlText 相对应的 text。但是，如果 LayoutManager 开始运行，则 text 属性值将更改为删除了所有 HTML 标记的 htmlText 字符串，即此值为 TextInput 实际显示的字符。

反之，如果设置 text 属性，则先前设置的任何 htmlText 都将是不相关的。如果设置 text 属性后立即读取 htmlText 属性，则您将收到 null，这表明尚未确定与新的 text 相对应的 htmlText。但是，如果 LayoutManager 开始运行，htmlText 属性值更改为新的文本以及 CSS 样式的 HTML 标记。

要使 LayoutManager 立即运行，您可以调用 TextInput 的 validateNow() 方法。例如，您可以设置一些 htmlText，调用 validateNow() 方法，然后立即获得相应的不包含 HTML 标记的 text。

如果在 ActionScript 中设置 text 和 htmlText 两种属性，则最后设置的属性会生效。切勿在 MXML 中同时设置这两种属性，因为 MXML 不保证能够以特定顺序对实例的属性进行设置。

在某个循环内设置 text 或 htmlText 属性的操作完成得很快，因为实际呈示文本的基础 TextField 在 LayoutManager 运行后才更新。

如果尝试将此属性设置为 null，则该属性将设置为空字符串。如果属性值暂时为 null，则表明刚刚设置了 text，但尚未确定相应的 htmlText。

flash.system.IMEConversionMode 类定义此属性的有效值的常量。您还可以指定 null 不指定任何 IME 模式。

您无需在 MXML 或 ActionScript 中设置此属性；将组件用作嵌入式项呈示器或嵌入式项目编辑器时，Flex 会对其进行设置。

只有在组件经过验证后，textHeight 属性的值才是正确的。如果您在设置 text 后立即请求 textHeight，则接收到的值可能不正确。您应等待组件经过验证或调用 validateNow() 方法后，再获取此值。此行为与 flash.text.TextField 控件有所不同，后者会立即更新此值。

只有在组件经过验证后，textWidth 属性的值才是正确的。如果您在设置 text 后立即请求 textWidth，则接收到的值可能不正确。您应等待组件经过验证或调用 validateNow() 方法后，再获取此值。此行为与 flash.text.TextField 控件有所不同，后者会立即更新此值。

对于诸如 Menu、List 或 TileList 等弹出式控件，可以保留此属性的默认值 (true)，因为这些控件应在进行活动时关闭。但是，对于多重选择和其他类型的弹出式控件，可以将此属性设置为 false，以避免弹出式控件在进行活动时关闭。

如果要将此属性指定为 MXML 中的某个属性，则必须使用对数据描述符的引用，而不是描述符的字符串名称。为该属性使用下列格式：

<mx:PopUpMenuButton id="menubar" dataDescriptor="{new MyCustomDataDescriptor()}"/>

或者，您可以在 MXML 中将该属性指定为嵌套子标签，如下例所示：

<mx:PopUpMenuButton>
      <mx:dataDescriptor>
         <myCustomDataDescriptor>
      </mx:dataDescriptor>
      ...

默认值为 DefaultDataDescriptor 类的内部实例。

项呈示器在数据提供程序中查找具有指定给 iconField 属性的名称的属性。如果该属性的值是 Class，则它会对该类进行实例化，而且它应为 IFlexDisplayObject 实例。如果该属性的值是 String，则它会查找以确定应用程序中是否存在具有该名称的 Class 属性。如果在应用程序上找不到属性，则它会在文档上查找具有该名称的属性，并使该属性映射到某个 Class。

如果数据提供程序是一个 E4X XML 对象，则必须显式设置此属性；例如，使用 @icon 指定 icon 属性。

默认情况下，该菜单不会尝试将图标与行中的文本一起显示。但是，通过指定图标函数，您可以为将创建并显示为行中的一个图标的图形指定一个类。

iconFunction 仅采用数据提供程序中的某个项目作为唯一参数，并返回一个类：

iconFunction(item:Object):Class

如果指定此属性，则标签函数必须查找一个或多个合适的字段并返回可显示的字符串。labelFunction 属性非常适用于处理格式设置和本地化。

标签函数必须使用 dataProvider 中的项目作为唯一的自变量，并返回一个字符串，如以下示例所示：

labelFunction(item:Object):String

此属性是只读的，设置它不会产生任何效果。但可以通过设置 dataProvider 属性实现所需效果。（只写指示符显示在语法摘要中，因为 superclass 中的属性是可读写的，而此类将使用空的实现覆盖 setter。）

将控件用作嵌入式项呈示器或嵌入式项目编辑器时，Flex 自动将项目的当前值写入此控件的 value 属性。

flash.system.IMEConversionMode 类定义此属性的有效值的常量。您还可以指定 null 不指定任何 IME 模式。

您无需在 MXML 或 ActionScript 中设置此属性；将组件用作嵌入式项呈示器或嵌入式项目编辑器时，Flex 会对其进行设置。