Пакет | 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Скрыть синтаксис 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):void
defaultInvalidValueError | свойство |
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):void
error | свойство |
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():IResourceManager
Formatter | () | Конструктор |
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