Пакет | 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 |
The <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():String
leadingZero | свойство |
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