| Пакет | 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
Скрыть синтаксис MXMLThe Formatter class defines the following tag attributes, which all of its subclasses inherit:
<mx:tagname
Properties
error=""
/>
| Свойство | Определено | ||
|---|---|---|---|
 | constructor : Object
Ссылка на объект класса или функцию конструктора для данного экземпляра объекта. | Object | |
| defaultInvalidFormatError : String [статические]
Сообщение об ошибке в случае недопустимой строки формата, указанной для средства форматирования. | Formatter | ||
| defaultInvalidValueError : String [статические]
Сообщения об ошибках в случае недопустимого значения, указанного для средства форматирования. | Formatter | ||
| error : String
Описание, сохраняемое средством форматирования при появлении ошибки. | Formatter | ||
| Свойство | Определено | ||
|---|---|---|---|
| resourceManager : IResourceManager [только для чтения]
Ссылка на объект, управляющий всеми локализованными ресурсами приложения. | Formatter | ||
| Метод | Определено | ||
|---|---|---|---|
Конструктор. | Formatter | ||
Форматирует значение и возвращает строку с новым отформатированным значением. | Formatter | ||
|
Показывает, определено ли заданное свойство для объекта. | Object | |
|
Показывает, есть ли экземпляр класса Object в цепи прототипов объекта, заданного в качестве параметра. | Object | |
|
Показывает наличие заданного свойства и его перечисляемость. | Object | |
|
Задает доступность динамического свойства для операций цикла. | Object | |
|
Возвращает строковое представление этого объекта, отформатированного в соответствии со стандартами, принятыми для данной локали. | Object | |
|
Возвращает строковое представление заданного объекта. | Object | |
|
Возвращает элементарное значение заданного объекта. | Object | |
| Метод | Определено | ||
|---|---|---|---|
Этот метод вызывается при создании класса Formatter и далее при каждой передаче события change для указания какого-либо изменения локализованных ресурсов. | Formatter | ||
defaultInvalidFormatError | свойство |
defaultInvalidFormatError:String| Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flex 3 |
| Версии среды выполнения: | Flash Player 9, AIR 1.1 |
Сообщение об ошибке в случае недопустимой строки формата, указанной для средства форматирования.
Значением по умолчанию является "Invalid format".
Реализация
public static function get defaultInvalidFormatError():String public static function set defaultInvalidFormatError(value:String):voiddefaultInvalidValueError | свойство |
defaultInvalidValueError:String| Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flex 3 |
| Версии среды выполнения: | Flash Player 9, AIR 1.1 |
Сообщения об ошибках в случае недопустимого значения, указанного для средства форматирования.
Значением по умолчанию является "Invalid value".
Реализация
public static function get defaultInvalidValueError():String public static function set defaultInvalidValueError(value:String):voiderror | свойство |
public var error:String| Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flex 3 |
| Версии среды выполнения: | Flash Player 9, AIR 1.1 |
Описание, сохраняемое средством форматирования при появлении ошибки. Для получения возможных значений этого свойства см. описание каждого средства форматирования.
Подклассы должны устанавливать это значение в методе format().
resourceManager | свойство |
resourceManager:IResourceManager [только для чтения] | Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flex 3 |
| Версии среды выполнения: | Flash Player 9, AIR 1.1 |
Ссылка на объект, управляющий всеми локализованными ресурсами приложения. Это одиночный экземпляр единичного предмета, реализующий интерфейс IResourceManager.
Это свойство можно использовать в качестве источника для связывания данных. При изменении этого свойства отправляется событие unused .
Реализация
protected function get resourceManager():IResourceManagerFormatter | () | Конструктор |
public function Formatter()| Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flex 3 |
| Версии среды выполнения: | Flash Player 9, AIR 1.1 |
Конструктор.
format | () | метод |
public function format(value:Object):String| Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flex 3 |
| Версии среды выполнения: | Flash Player 9, AIR 1.1 |
Форматирует значение и возвращает строку с новым отформатированным значением. Все подклассы должны отменять этот метод для реализации средства форматирования.
Параметры
value:Object — Значение для форматирования.
|
String — Отформатированная строка.
|
resourcesChanged | () | метод |
protected function resourcesChanged():void| Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flex 3 |
| Версии среды выполнения: | Flash Player 9, AIR 1.1 |
Этот метод вызывается при создании класса Formatter и далее при каждой передаче события change для указания на какое-либо изменение локализованных ресурсов.
Это событие передается при установке значения для свойства ResourceManager localeChain после завершения загрузки модуля ресурсов и при вызове метода ResourceManager update().
Подклассы должны отменять этот метод и после вызова super.resourcesChanged() выполнять соответствующую операцию в ответ на получение новых значений ресурсов.
<?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:34 AM Z