| Пакет | spark.formatters.supportClasses |
| Класс | public class NumberFormatterBase |
| Наследование | NumberFormatterBase GlobalizationBase AdvancedStyleClient EventDispatcher Object |
| Подклассы | CurrencyFormatter, NumberFormatter |
| Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flex 4.5 |
| Версии среды выполнения: | Flash Player 10, AIR 2.5 |
Скрыть синтаксис MXMLThe <s:NumberFormatterBase> tag inherits all of the tag
attributes of its superclass and adds the following tag attributes:
<s:NumberFormatterBase
Properties
decimalSeparator="locale and OS dependent"
digitsType="locale and OS dependent"
errorText="null"
fractionalDigits="locale and OS dependent"
groupingPattern="locale and OS dependent"
groupingSeparator="locale and OS dependent"
leadingZero="locale and OS dependent"
negativeSymbol="locale and OS dependent"
trailingZeros="locale and OS dependent"
useGrouping="locale and OS dependent"
/>
Связанные элементы API
| Свойство | Определено | ||
|---|---|---|---|
![]() | actualLocaleIDName : String [только для чтения]
Имя фактического идентификатора локали, используемое этим объектом класса. | GlobalizationBase | |
![]() | className : String [только для чтения]
Имя класса компонента. | AdvancedStyleClient | |
![]() | constructor : Object
Ссылка на объект класса или функцию конструктора для данного экземпляра объекта. | Object | |
| decimalSeparator : String
Символ-разделитель десятичной дроби, используемый для форматирования или анализа чисел с дробной частью. | NumberFormatterBase | ||
| digitsType : uint
Определяет набор цифровых символов, которые должны использоваться при форматировании чисел. | NumberFormatterBase | ||
| errorText : String
Строка замены, возвращенная методом format() при возникновении ошибки. | NumberFormatterBase | ||
| fractionalDigits : int
Максимальное число цифр, которые могут отображаться после десятичного разделителя. | NumberFormatterBase | ||
| groupingPattern : String
Описывает размещение разделителей группировки в пределах отформатированной числовой строки. | NumberFormatterBase | ||
| groupingSeparator : String
Символ или строка, используемые в качестве разделителя группировки. | NumberFormatterBase | ||
![]() | id : String
Идентификатор компонента. | AdvancedStyleClient | |
![]() | inheritingStyles : Object
Объект, содержащий стили наследования для экземпляра клиента с невизуальным стилем. | AdvancedStyleClient | |
| lastOperationStatus : String [переопределить] [только для чтения]
Состояние самой последней операции, выполненной этим объектом класса. | NumberFormatterBase | ||
| leadingZero : Boolean
Определяет, включается ли начальный нуль в отформатированное число, если слева от десятичного разделителя нет целых чисел. | NumberFormatterBase | ||
![]() | moduleFactory : IFlexModuleFactory
Фабрика модуля, используемая в качестве контекста для поиска менеджера стилей, управляющего стилями в этом экземпляре клиента с невизуальным стилем. | AdvancedStyleClient | |
| negativeSymbol : String
Отрицательный символ, который должен использоваться при форматировании отрицательных величин. | NumberFormatterBase | ||
![]() | nonInheritingStyles : Object
Начало цепочки этого компонента с ненаследуемыми стилями. | AdvancedStyleClient | |
![]() | styleDeclaration : CSSStyleDeclaration
Объявление стиля, которое содержит действующие стили, объявленные этим объектом. | AdvancedStyleClient | |
![]() | styleManager : IStyleManager2 [только для чтения]
Возвращает экземпляр StyleManager, используемый этим компонентом. | AdvancedStyleClient | |
![]() | styleName : Object
Источник значений стиля данного объекта. | AdvancedStyleClient | |
![]() | styleParent : IAdvancedStyleClient
Вышестоящий узел компонента используется для анализа нижестоящих селекторов. | AdvancedStyleClient | |
| trailingZeros : Boolean
Определяет, добавляются ли нули в конце форматируемого числа. | NumberFormatterBase | ||
| useGrouping : Boolean
Позволяет использовать разделитель группировки при форматировании чисел. | NumberFormatterBase | ||
| Метод | Определено | ||
|---|---|---|---|
Конструктор. | NumberFormatterBase | ||
![]() | addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void
Регистрирует объект прослушивателя события на объекте EventDispatcher для получения прослушивателем уведомления о событии. | EventDispatcher | |
![]() |
Удаляет свойство style для экземпляра компонента. | AdvancedStyleClient | |
![]() |
Посылает событие в поток событий. | EventDispatcher | |
![]() |
Возвращает массив объектов CSSStyleDeclaration для селектора типа, применяемого к этому компоненту, или null, если массив не существует. | AdvancedStyleClient | |
![]() | [переопределить]
Получает свойство style, которое было установлено в любом месте в пределах цепочки поиска стиля этого компонента. | GlobalizationBase | |
![]() |
Возвращает true, если для currentCSSState не указано значение null. | AdvancedStyleClient | |
![]() |
Проверяет, имеет ли объект EventDispatcher прослушиватели, зарегистрированные для определенного типа события. | EventDispatcher | |
![]() |
Показывает, определено ли заданное свойство для объекта. | Object | |
![]() |
Инициализированный метод вызывается, когда этот класс или класс, расширяющий этот класс, используются в объявлении MXML. | AdvancedStyleClient | |
![]() |
Показывает, есть ли экземпляр класса Object в цепи прототипов объекта, заданного в качестве параметра. | Object | |
![]() |
Возвращает значение true, если cssState совпадает с currentCSSState. | AdvancedStyleClient | |
![]() |
Определяет, совпадает ли этот экземпляр с данным типом (или является его подклассом). | AdvancedStyleClient | |
![]() |
Применяет изменения стиля к нижестоящим элементам этого экземпляра клиента стиля. | AdvancedStyleClient | |
![]() |
Показывает наличие заданного свойства и его перечисляемость. | Object | |
![]() |
Обеспечивает настройку внутренних значений кэша стиля для функционирования метода getStyle(). | AdvancedStyleClient | |
![]() |
Обеспечивает регистрацию EffectManager в качестве одного из прослушивателей события для каждого события эффекта. | AdvancedStyleClient | |
![]() |
Удаляет прослушиватель из объекта EventDispatcher. | EventDispatcher | |
![]() |
Задает доступность динамического свойства для операций цикла. | Object | |
![]() |
Задает свойство style для экземпляра компонента. | AdvancedStyleClient | |
![]() |
Обеспечивает обнаружение изменений в свойствах стиля. | AdvancedStyleClient | |
![]() |
Метод stylesInitialized() вызывается программой Flex при первой инициализации стиля компонента. | AdvancedStyleClient | |
![]() |
Возвращает строковое представление этого объекта, отформатированного в соответствии со стандартами, принятыми для данной локали. | Object | |
![]() |
Возвращает строковое представление заданного объекта. | Object | |
![]() |
Возвращает элементарное значение заданного объекта. | Object | |
![]() |
Проверяет, зарегистрирован ли прослушиватель события для указанного типа события с данным объектом EventDispatcher или любым его предшественником. | EventDispatcher | |
Стили являются либо общими, либо связанными с определенной темой. Если стиль общий, он может использоваться с любой темой. Если стиль связан с определенной темой, он может использоваться, только если ваше приложение использует ее.
decimalSeparator | свойство |
decimalSeparator:String| Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flex 4.5 |
| Версии среды выполнения: | Flash Player 10, AIR 2.5 |
Символ-разделитель десятичной дроби, используемый для форматирования или анализа чисел с дробной частью.
Значение по умолчанию зависит от локали и операционной системы.
Это свойство можно использовать в качестве источника для связывания данных. При изменении этого свойства отправляется событие change .
Реализация
public function get decimalSeparator():String public function set decimalSeparator(value:String):voidВыдает
TypeError — если это свойство имеет нулевое значение.
|
Связанные элементы API
digitsType | свойство |
digitsType:uint| Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flex 4.5 |
| Версии среды выполнения: | Flash Player 10, AIR 2.5 |
Определяет набор цифровых символов, которые должны использоваться при форматировании чисел.
В различных языках и регионах используются разные символы для представления цифр 0—9. Это свойство определяет используемый набор цифр.
Значение этого свойства представляет значение Юникод для обозначения нуля в десятичном наборе цифр. Действительные значения для этого свойства определены в классе NationalDigitsType.
Значение по умолчанию зависит от локали и операционной системы.
Это свойство можно использовать в качестве источника для связывания данных. При изменении этого свойства отправляется событие change .
Реализация
public function get digitsType():uint public function set digitsType(value:uint):voidСвязанные элементы API
errorText | свойство |
errorText:String| Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flex 4.5 |
| Версии среды выполнения: | Flash Player 10, AIR 2.5 |
Строка замены, возвращенная методом format() при возникновении ошибки.
Если errorText не является null и ошибка возникает при форматировании количества или денежной суммы, метод формата возвратит строку, присвоенную этому свойству.
var nf:NumberFormatter = new NumberFormatter();
nf.setStyle("locale", "en-US");
nf.errorText = "###"
trace(nf.format("abc")); // ###
Значением по умолчанию является null.
Это свойство можно использовать в качестве источника для связывания данных. При изменении этого свойства отправляется событие change .
Реализация
public function get errorText():String public function set errorText(value:String):voidСвязанные элементы API
fractionalDigits | свойство |
fractionalDigits:int| Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flex 4.5 |
| Версии среды выполнения: | Flash Player 10, AIR 2.5 |
Максимальное число цифр, которые могут отображаться после десятичного разделителя.
Числа округляются до указанного в этом свойстве количества знаков. Схема округления варьируется в зависимости от операционной системы пользователя приложения.
Когда свойство trailingZeros имеет значение true, дробная часть числа (после запятой) дополняется нулями, чтобы ее длина соответствовала значению данного свойства fractionalDigits.
Значение по умолчанию зависит от локали и операционной системы.
Это свойство можно использовать в качестве источника для связывания данных. При изменении этого свойства отправляется событие change .
Реализация
public function get fractionalDigits():int public function set fractionalDigits(value:int):voidСвязанные элементы API
groupingPattern | свойство |
groupingPattern:String| Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flex 4.5 |
| Версии среды выполнения: | Flash Player 10, AIR 2.5 |
Описывает размещение разделителей группировки в пределах отформатированной числовой строки.
Когда свойство useGrouping имеет значение true, свойство groupingPattern используется для определения местоположения разделителя группировки и используемого шаблона.
Шаблон группировки определяется как строка, содержащая числа, разделенные точкой с запятой и в некоторых случаях может оканчиваться звездочкой. Например: "3;2;*". Каждое число в строке представляет собой количество цифр в группе. Разделитель группировки помещается перед каждой группой цифр. Звездочка в конце строки обозначает, что группы с этим числом цифр должны повторяться до конца отформатированной строки. Если звездочки нет, то в оставшейся части отформатированной строки нет дополнительных групп или символов.
Первое число в строке соответствует первой группе цифр слева от десятичного разделителя. Последующие числа определяют количество цифр в следующих группах слева. Таким образом строка "3;2;*" обозначает, что разделитель группировки ставится после первой группы из 3 цифр, за которой следуют группы из 2 цифр. Например: 98,76,54,321
В следующей таблице приводятся примеры форматирования числа 123456789,12 с различными шаблонами группировки. В данном случае в качестве разделителя группировки используется запятая, а в качестве десятичного разделителя — точка.
| Шаблон группировки | Образец формата |
3;* | 123,456,789.12 |
3;2;* | 12,34,56,789.12 |
3 | 123456,789.12 |
Можно определить лишь ограниченное число размеров группировки. В одних операционных системах шаблоны группировки могут содержать только два числа и звездочку. Другие операционные системы могут поддерживать до четырех чисел и звездочку. Когда речь идет о шаблонах без звездочки, одни операционные системы поддерживают только одно число, а другие до трех чисел. Если превышено максимальное число элементов группировки, то лишние элементы игнорируются и свойство lastOperationStatus обозначает, что используется резервное значение.
Значение по умолчанию зависит от локали и операционной системы.
Это свойство можно использовать в качестве источника для связывания данных. При изменении этого свойства отправляется событие change .
Реализация
public function get groupingPattern():String public function set groupingPattern(value:String):voidВыдает
TypeError — если это свойство имеет нулевое значение.
|
Связанные элементы API
groupingSeparator | свойство |
groupingSeparator:String| Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flex 4.5 |
| Версии среды выполнения: | Flash Player 10, AIR 2.5 |
Символ или строка, используемые в качестве разделителя группировки.
Значение этого свойства используется в качестве разделителя группировки при форматировании числа, когда свойство useGrouping имеет значение true. Это свойство изначально задается на основе локали, выбранной при создании объекта NumberFormatter.
Значение по умолчанию зависит от локали и операционной системы.
Это свойство можно использовать в качестве источника для связывания данных. При изменении этого свойства отправляется событие change .
Реализация
public function get groupingSeparator():String public function set groupingSeparator(value:String):voidВыдает
TypeError — если это свойство имеет нулевое значение.
|
Связанные элементы API
lastOperationStatus | свойство |
lastOperationStatus:String [только для чтения] [переопределить] | Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flex 4.5 |
| Версии среды выполнения: | Flash Player 10, AIR 2.5 |
Состояние самой последней операции, выполненной этим объектом класса. Свойство lastOperationStatus задается каждый раз при вызове конструктора или метода этого класса или при задании значения для другого свойства. Другие возможные значения см. в описании соответствующего метода.
Это свойство можно использовать в качестве источника для связывания данных. При изменении этого свойства отправляется событие change .
Реализация
override public function get lastOperationStatus():StringleadingZero | свойство |
leadingZero:Boolean| Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flex 4.5 |
| Версии среды выполнения: | Flash Player 10, AIR 2.5 |
Определяет, включается ли начальный нуль в отформатированное число, если слева от десятичного разделителя нет целых чисел.
Когда это свойство имеет значение true, начальный нуль добавляется слева от десятичного разделителя при форматировании числовых значений в диапазоне от -1,0 до 1,0. Когда это свойство имеет значение false, начальный нуль не добавляется.
Например, если форматируется число 0,321 и это свойство имеет значение true, в отформатированную строку включается начальный нуль. Если свойство имеет значение false, то начальный нуль не включается. В этом случае строка будет содержать только десятичный разделитель и дробную часть: ,321.
В следующей таблице приводятся примеры форматирования чисел на основе значений этого свойства, а также связанных свойств fractionalDigits и trailingZeros.
| trailingZeros | leadingZero | fractionalDigits | 0.12 | 0 |
| true | true | 3 | 0.120 | 0.000 |
| false | true | 3 | 0.12 | 0 |
| true | false | 3 | .120 | .000 |
| false | false | 3 | .12 | 0 |
Значение по умолчанию зависит от локали и операционной системы.
Это свойство можно использовать в качестве источника для связывания данных. При изменении этого свойства отправляется событие change .
Реализация
public function get leadingZero():Boolean public function set leadingZero(value:Boolean):voidВыдает
TypeError — если это свойство имеет нулевое значение.
|
Связанные элементы API
negativeSymbol | свойство |
negativeSymbol:String| Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flex 4.5 |
| Версии среды выполнения: | Flash Player 10, AIR 2.5 |
Отрицательный символ, который должен использоваться при форматировании отрицательных величин.
Этот символ используется вместе с форматом отрицательных чисел при форматировании чисел, которые меньше нуля. Он не используется в форматах отрицательных чисел, которые не включают отрицательный символ (например, когда отрицательные числа заключены в круглые скобки).
Этому свойству задается значение по умолчанию для фактической локали, выбранной при создании этого объекта NumberFormatter. Ему можно присвоить значение для переопределения настройки по умолчанию.
Значение по умолчанию зависит от локали и операционной системы.
Это свойство можно использовать в качестве источника для связывания данных. При изменении этого свойства отправляется событие change .
Реализация
public function get negativeSymbol():String public function set negativeSymbol(value:String):voidСвязанные элементы API
trailingZeros | свойство |
trailingZeros:Boolean| Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flex 4.5 |
| Версии среды выполнения: | Flash Player 10, AIR 2.5 |
Определяет, добавляются ли нули в конце форматируемого числа.
Когда это свойство имеет значение true, в конце дробной части отформатированного числа добавляются нули, чтобы его длина соответствовала ограничению, определенному в свойстве fractionalDigits. Когда это свойство имеет значение false, нули в конце числа не отображаются.
Например, если форматируется числовое значение 123,4 и это свойство имеет значение true, а свойству fractionalDigits задано значение 3, в конце отформатированной строки будут отображаться нули: 123,400. Если же это свойство имеет значение false, нули в конце строки не добавляются и после десятичного разделителя отображаются только ненулевые цифры: 123,4.
В следующей таблице приводятся примеры форматирования чисел на основе значений этого свойства, а также связанных свойств fractionalDigits и leadingZero.
| trailingZeros | leadingZero | fractionalDigits | 0.12 | 0 |
| true | true | 3 | 0.120 | 0.000 |
| false | true | 3 | 0.12 | 0 |
| true | false | 3 | .120 | .000 |
| false | false | 3 | .12 | 0 |
Значение по умолчанию зависит от локали и операционной системы.
Это свойство можно использовать в качестве источника для связывания данных. При изменении этого свойства отправляется событие change .
Реализация
public function get trailingZeros():Boolean public function set trailingZeros(value:Boolean):voidВыдает
TypeError — если это свойство имеет нулевое значение.
|
Связанные элементы API
useGrouping | свойство |
useGrouping:Boolean| Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flex 4.5 |
| Версии среды выполнения: | Flash Player 10, AIR 2.5 |
Позволяет использовать разделитель группировки при форматировании чисел.
Когда свойство useGrouping имеет значение true, цифры группируются и разделяются с использованием символа-разделителя группировки. Например, 123,456,789.22
Когда свойство useGrouping имеет значение false, цифры не группируются и не разделяются. Например, 123456789.22
Символ, который должен использоваться в качестве разделителя группировки, определяется свойством groupingSeparator. Число знаком между разделителями группировки определяется свойством groupingPattern.
Значение по умолчанию зависит от локали и операционной системы.
Это свойство можно использовать в качестве источника для связывания данных. При изменении этого свойства отправляется событие change .
Реализация
public function get useGrouping():Boolean public function set useGrouping(value:Boolean):voidСвязанные элементы API
NumberFormatterBase | () | Конструктор |
public function NumberFormatterBase()| Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flex 4.5 |
| Версии среды выполнения: | Flash Player 10, AIR 2.5 |
Конструктор.
Tue Jun 12 2018, 11:34 AM Z
Показать синтаксис MXML