| 包 | mx.formatters |
| 类 | public class Formatter |
| 继承 | Formatter  Object |
| 实现 | IFormatter |
| 子类 | CurrencyFormatter, DateFormatter, NumberFormatter, PhoneFormatter, ZipCodeFormatter |
| 语言版本: | ActionScript 3.0 |
| 产品版本: | Flex 3 |
| 运行时版本: | Flash Player 9, AIR 1.1 |
format() 方法。
MXML 语法
显示 MXML 语法
隐藏 MXML 语法The Formatter class defines the following tag attributes, which all of its subclasses inherit:
<mx:tagname
Properties
error=""
/>
公共属性
| 属性 | 由以下参数定义 | ||
|---|---|---|---|
 | constructor : Object
对类对象或给定对象实例的构造函数的引用。 | Object | |
| defaultInvalidFormatError : String [静态]
为 formatter 指定的格式字符串无效时出现的错误消息。 | Formatter | ||
| defaultInvalidValueError : String [静态]
为 formatter 指定的值无效时出现的错误消息。 | Formatter | ||
| error : String
发生错误时由 formatter 保存的说明。 | Formatter | ||
受保护的属性
| 属性 | 由以下参数定义 | ||
|---|---|---|---|
| resourceManager : IResourceManager [只读]
对管理所有应用程序本地化资源的对象的引用。 | Formatter | ||
公共方法
| 方法 | 由以下参数定义 | ||
|---|---|---|---|
构造函数。 | Formatter | ||
设置值的格式，并返回一个包含已格式化的新值的 String。 | Formatter | ||
|
表示对象是否已经定义了指定的属性。 | Object | |
|
表示 Object 类的实例是否在指定为参数的对象的原型链中。 | Object | |
|
表示指定的属性是否存在、是否可枚举。 | Object | |
|
设置循环操作动态属性的可用性。 | Object | |
|
返回此对象的字符串表示形式，其格式设置遵守区域设置特定的约定。 | Object | |
|
返回指定对象的字符串表示形式。 | Object | |
|
返回指定对象的原始值。 | Object | |
受保护的方法
| 方法 | 由以下参数定义 | ||
|---|---|---|---|
构建 Formatter 时将调用此方法，并且每当 ResourceManager 调度“change”事件来指示本地化资源已经过某种更改时，都会再次调用此方法。 | Formatter | ||
属性详细信息
defaultInvalidFormatError | 属性 |
defaultInvalidValueError | 属性 |
error | 属性 |
public var error:String| 语言版本: | ActionScript 3.0 |
| 产品版本: | Flex 3 |
| 运行时版本: | Flash Player 9, AIR 1.1 |
发生错误时由 formatter 保存的说明。有关此属性的可能值，请参阅每个 formatter 的说明。
子类必须在 format() 方法中设置此值。
resourceManager | 属性 |
resourceManager:IResourceManager [只读] | 语言版本: | ActionScript 3.0 |
| 产品版本: | Flex 3 |
| 运行时版本: | Flash Player 9, AIR 1.1 |
对管理所有应用程序本地化资源的对象的引用。此项是 singleton 实例，实现 IResourceManager 接口。
此属性可用作数据绑定的源。修改此属性后，将调度 unused 事件。
实现
protected function get resourceManager():IResourceManager构造函数详细信息
Formatter | () | 构造函数 |
public function Formatter()| 语言版本: | ActionScript 3.0 |
| 产品版本: | Flex 3 |
| 运行时版本: | Flash Player 9, AIR 1.1 |
构造函数。
方法详细信息
format | () | 方法 |
resourcesChanged | () | 方法 |
protected function resourcesChanged():void| 语言版本: | ActionScript 3.0 |
| 产品版本: | Flex 3 |
| 运行时版本: | Flash Player 9, AIR 1.1 |
构建 Formatter 时将调用此方法，并且每当 ResourceManager 调度 "change" 事件来指示本地化资源已经过某种更改时，都会再次调用此方法。
在下列情形中调度此事件：设置 ResourceManager 的 localeChain 属性时，资源模块完成加载时，以及调用 ResourceManager 的 update() 方法时。
子类应覆盖此方法，并在调用 super.resourcesChanged() 后，执行任何适当的操作以响应新资源值。
示例 如何使用本示例
SimpleFormatterExample.mxml
<?xml version="1.0" encoding="utf-8"?>
<!-- Simple example to demonstrate the Formatter class. -->
<s:Application xmlns:fx="http://ns.adobe.com/mxml/2009"
xmlns:s="library://ns.adobe.com/flex/spark"
xmlns:mx="library://ns.adobe.com/flex/mx">
<fx:Script>
<![CDATA[
// Event handler to format the input.
private function Format():void {
// The format() method returns the formatted String,
// or an empty String if there is an error.
var formattedVal:String = numberFormatter.format(inputVal.text);
if (formattedVal.length == 0) {
// If there is an error, the Format.error property
// contains the reason.
formattedNumber.text = numberFormatter.error;
} else {
formattedNumber.text = formattedVal;
}
}
]]>
</fx:Script>
<fx:Declarations>
<mx:NumberFormatter id="numberFormatter" />
</fx:Declarations>
<s:Panel title="NumberFormatter Example"
width="75%" height="75%"
horizontalCenter="0" verticalCenter="0">
<mx:Form left="10" right="10" top="10" bottom="10">
<mx:FormItem label="Enter number - a letter is invalid:">
<s:TextInput id="inputVal" text="" width="75%"/>
</mx:FormItem>
<mx:FormItem label="Formatted number: ">
<s:TextInput id="formattedNumber" editable="false" width="75%"/>
</mx:FormItem>
<mx:FormItem>
<s:Button label="Validate and Format" click="Format();"/>
</mx:FormItem>
</mx:Form>
</s:Panel>
</s:Application>
Tue Jun 12 2018, 11:04 AM Z