| Пакет | spark.validators |
| Класс | public class NumberValidator |
| Наследование | NumberValidator  NumberValidatorBase GlobalizationValidatorBase GlobalizationBase AdvancedStyleClient EventDispatcher Object |
| Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flex 4.5 |
| Версии среды выполнения: | Flash Player 10.1, AIR 2.5 |
int, uint и Number.
Этот класс использует стиль locale для указания запрашиваемого идентификатора локали.
Средство проверки гарантирует, что введенное число соответствует указанному диапазону (определяется свойствами minValue и maxValue), является целым числом (определяется свойством domain), является неотрицательным числом (определяется свойством allowNegative), правильно указывает отрицательные и положительные числа и не превышает указанное количество fractionalDigits. Поскольку средство проверки устанавливает стандартные значения свойств с помощью класса flash.globalization.NumberFormatter, значения на основе локалей предоставляет операционная система.
Класс NumberValidator можно использовать в объявлениях MXML или коде ActionScript. Этот класс использует стиль локали для указания запрашиваемого Locale ID, который требуется для класса flash.globalization.NumberFormatter и содержит привязываемые методы и свойства.
Показать синтаксис MXML
Скрыть синтаксис MXMLThe <spark:NumberValidator> tag
inherits all of the tag attributes of its superclass,
and adds the following tag attributes:
<s:NumberValidator
Properties
negativeNumberFormat="locale specified string or customized by user."
negativeNumberFormatError="The negative format of the input number is incorrect."
/>
Связанные элементы API
Общедоступные свойства
| Свойство | Определено | ||
|---|---|---|---|
 | actualLocaleIDName : String [только для чтения]
Имя фактического идентификатора локали, используемое этим объектом класса. | GlobalizationBase | |
| allowNegative : Boolean
Указывает возможность использования отрицательных чисел. | NumberValidatorBase | |
| className : String [только для чтения]
Имя класса компонента. | AdvancedStyleClient | |
| constructor : Object
Ссылка на объект класса или функцию конструктора для данного экземпляра объекта. | Object | |
| decimalPointCountError : String
Сообщение об ошибке при обнаружении нескольких десятичных разделителей. | NumberValidatorBase | |
| decimalSeparator : String
Символ десятичного разделителя используется для проверки чисел, имеющих знаки после запятой. | NumberValidatorBase | |
| digitsType : uint
Определяет набор цифровых символов, которые должны использоваться при проверке чисел. | NumberValidatorBase | |
| domain : String
Тип проверяемого числа. | NumberValidatorBase | |
| enabled : Boolean
Установка этого значения на false помешает выполнению проверки средством проверки. | GlobalizationValidatorBase | |
| fractionalDigits : int
Максимальное число цифр, которые могут отображаться после десятичного разделителя. | NumberValidatorBase | |
| fractionalDigitsError : String
Сообщение об ошибке, когда цифры дроби превышают значение, указанное в свойстве fractionalDigits. | NumberValidatorBase | |
| greaterThanMaxError : String
Сообщение об ошибке, если значение превышает свойство maxValue. | NumberValidatorBase | |
| groupingSeparator : String
Символ или строка, используемые в качестве разделителя группировки. | NumberValidatorBase | |
| id : String
Идентификатор компонента. | AdvancedStyleClient | |
| inheritingStyles : Object
Объект, содержащий стили наследования для экземпляра клиента с невизуальным стилем. | AdvancedStyleClient | |
| invalidCharError : String
Сообщение об ошибке при обнаружении в значении недопустимых символов. | NumberValidatorBase | |
| invalidFormatCharsError : String
Сообщение об ошибке при обнаружении в значении символов недопустимого формата, т. е. числа или знака «минус» (-) в качестве символа-разделителя или двух или более последовательных символов-разделителей. | NumberValidatorBase | |
| lastOperationStatus : String [переопределить] [только для чтения]
Состояние самой последней операции, выполненной этим объектом класса. | NumberValidatorBase | |
| lessThanMinError : String
Сообщение об ошибке, если значение меньше, чем minValue. | NumberValidatorBase | |
| listener : Object
Указывает прослушиватель проверки. | GlobalizationValidatorBase | |
| localeUndefinedError : String
Сообщение об ошибке при неопределенной или недоступной локали. | NumberValidatorBase | |
| maxValue : Number
Максимальное значение допустимого числа. | NumberValidatorBase | |
| minValue : Number
Минимальное значение допустимого числа. | NumberValidatorBase | |
| moduleFactory : IFlexModuleFactory
Фабрика модуля, используемая в качестве контекста для поиска менеджера стилей, управляющего стилями в этом экземпляре клиента с невизуальным стилем. | AdvancedStyleClient | |
| negativeError : String
Сообщение об ошибке, если значение отрицательное и свойство allowNegative имеет значение false. | NumberValidatorBase | |
| negativeNumberFormat : uint
Числовое значение, которое представляет образец проверки для отрицательных чисел. | NumberValidator | ||
| negativeNumberFormatError : String
Сообщение об ошибке, когда используемый формат отрицательного числа не соответствует шаблону, определенному в свойстве negativeNumberFormat. | NumberValidator | ||
| negativeSymbol : String [только для чтения]
Отрицательный символ для использования при проверке отрицательных значений. | NumberValidatorBase | |
| negativeSymbolError : String
Сообщение об ошибке, если отрицательный символ повторяется или находится в недопустимом местоположении. | NumberValidatorBase | |
| nonInheritingStyles : Object
Начало цепочки этого компонента с ненаследуемыми стилями. | AdvancedStyleClient | |
| notAnIntegerError : String
Сообщение об ошибке, если необходимо ввести целое число, как определено свойством domain. | NumberValidatorBase | |
| parseError : String
Сообщение об ошибке, когда не удается проанализировать число. | NumberValidatorBase | |
| property : String
Строка с именем свойства для объекта source, содержащего проверяемое значение. | GlobalizationValidatorBase | |
| required : Boolean = true
Значение true указывает на то, что ошибка проверки вызвана отсутствующим или пустым значением. | GlobalizationValidatorBase | |
| requiredFieldError : String
Сообщение об ошибке, если значение отсутствует, а свойство required имеет значение true. | GlobalizationValidatorBase | |
| source : Object
Указывает объект, содержащий проверяемое свойство. | GlobalizationValidatorBase | |
| styleDeclaration : CSSStyleDeclaration
Объявление стиля, которое содержит действующие стили, объявленные этим объектом. | AdvancedStyleClient | |
| styleManager : IStyleManager2 [только для чтения]
Возвращает экземпляр StyleManager, используемый этим компонентом. | AdvancedStyleClient | |
| styleName : Object
Источник значений стиля данного объекта. | AdvancedStyleClient | |
| styleParent : IAdvancedStyleClient
Вышестоящий узел компонента используется для анализа нижестоящих селекторов. | AdvancedStyleClient | |
| trigger : IEventDispatcher
Указывает компонент, генерирующий запускающее средство проверки событие. | GlobalizationValidatorBase | |
| triggerEvent : String
Указывает запускающее проверку событие. | GlobalizationValidatorBase | |
Защищенные свойства
Общедоступные методы
| Метод | Определено | ||
|---|---|---|---|
Создает новый объект NumberValidator для проверки чисел в соответствии с правилами данной локали. | NumberValidator | ||
| 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 | |
|
Выполняет проверку и дополнительно оповещает прослушиватели результата. | GlobalizationValidatorBase | |
| [статические]
Вызывает все средства проверки в массиве validators. | GlobalizationValidatorBase | |
Удобный метод для вызова средства проверки в пользовательской функции проверки. | NumberValidator | ||
|
Возвращает элементарное значение заданного объекта. | Object | |
|
Проверяет, зарегистрирован ли прослушиватель события для указанного типа события с данным объектом EventDispatcher или любым его предшественником. | EventDispatcher | |
События
Стили
Стили являются либо общими, либо связанными с определенной темой. Если стиль общий, он может использоваться с любой темой. Если стиль связан с определенной темой, он может использоваться, только если ваше приложение использует ее.
Общие стили
Сведения о свойстве
negativeNumberFormat | свойство |
negativeNumberFormat:uint| Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flex 4.5 |
| Версии среды выполнения: | Flash Player 10.1, AIR 2.5 |
Числовое значение, которое представляет образец проверки для отрицательных чисел. Этот шаблон определяет местоположение отрицательного символа или круглых скобок относительно числовой части проверяемого числа.
В следующей таблице сведены все возможные форматы отрицательных чисел. При проверке отрицательного числа знак минуса обозначает значение свойства negativeSymbol, а символ "n" – числовое значение.
| Тип формата отрицательного числа | Формат |
| 0 | (n) |
| 1 | -n |
| 2 | - n |
| 3 | n- |
| 4 | n - |
используемой локали и операционной системы.
Это свойство можно использовать в качестве источника для связывания данных. При изменении этого свойства отправляется событие change .
Реализация
public function get negativeNumberFormat():uint public function set negativeNumberFormat(value:uint):voidВыдает
ArgumentError — если присвоенное значение не является числом в диапазоне от 0 до 4.
|
Связанные элементы API
negativeNumberFormatError | свойство |
negativeNumberFormatError:String| Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flex 4.5 |
| Версии среды выполнения: | Flash Player 10.1, AIR 2.5 |
Сообщение об ошибке, когда используемый формат отрицательного числа не соответствует шаблону, определенному в свойстве negativeNumberFormat.
Значением по умолчанию является "The negative format of the input number is incorrect.".
Это свойство можно использовать в качестве источника для связывания данных. При изменении этого свойства отправляется событие change .
Реализация
public function get negativeNumberFormatError():String public function set negativeNumberFormatError(value:String):voidСведения о конструкторе
NumberValidator | () | Конструктор |
public function NumberValidator()| Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flex 4.5 |
| Версии среды выполнения: | Flash Player 10.1, AIR 2.5 |
Создает новый объект NumberValidator для проверки чисел в соответствии с правилами данной локали.
Стиль locale определяет локаль для этого класса. Стиль locale можно установить следующими способами.
-
Наследование стиля из
UIComponentпосредством вызова используемого вUIComponentметодаaddStyleClient. -
С использованием класса в объявлении MXML и наследованием локали из документа, содержащего объявление.
<fx:Declarations> <s:NumberValidator id="nv" /> </fx:Declarations> -
С использованием объявления MXML и указанием значения локали в списке назначений.
<fx:Declarations> <s:NumberValidator id="nv_French_France" locale="fr_FR" /> </fx:Declarations> -
Вызов метода
setStyle. Например,nv.setStyle("locale", "fr-FR")
Если стиль locale не установлен одним из вышеперечисленных способов, экземпляр этого класса добавляется как StyleClient в topLevelApplication и наследует стиль locale из объекта topLevelApplication при вызове получателя свойств, зависящего от locale, или метода, зависящего от locale.
Сведения о методе
validateNumber | () | метод |
public function validateNumber(value:Object, baseField:String):Array| Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flex 4.5 |
| Версии среды выполнения: | Flash Player 10.1, AIR 2.5 |
Удобный метод для вызова средства проверки в пользовательской функции проверки. Каждое стандартное средство проверки Flex имеет подобный удобный метод. Вызывающий модуль должен проверить объекты ValidationResult в возвращенном массиве для проверки состояния.
Параметры
value:Object — Числовая строка, которую необходимо проверить.
| |
baseField:String — Текстовое представление подчиненного поля определяется в объекте value. Например, если параметр value имеет значение value.number, то baseField имеет значение number.
|
Array — Массив объектов ValidationResult с одним объектом ValidationResult для каждого поля, проверенного средством проверки.
|
Связанные элементы API
Примеры Использование этого примера
NumberValidatorExample1.mxml
<?xml version="1.0" encoding="utf-8"?>
<!-- Sample program for spark.formatters.NumberValidator -->
<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:Declarations>
<s:NumberValidator id="numberValidator" source='{inputNumber}'
property="text" trigger='{validateBtn}'
triggerEvent="click" />
<s:NumberFormatter id="numberFormatter" useGrouping="true"/>
</fx:Declarations>
<fx:Script>
<![CDATA[
[Bindable]
private var number:Number = 123456789.12;
]]>
</fx:Script>
<mx:Form>
<mx:FormItem label="Input Locale ID Name">
<mx:HBox>
<s:TextInput id="inputLocaleIDName" text="en-US"/>
<!-- Upon button click, sets the locale style on the document
UI component. The formatter will inherit this style. -->
<s:Button click="setStyle('locale', inputLocaleIDName.text);"
label="Apply"/>
</mx:HBox>
<mx:Text text="Example: 'en-US', 'fr-FR', 'ja-JP', 'ar-SA'"/>
</mx:FormItem>
<mx:FormItem label="Allow Negative">
<mx:CheckBox id="alowNegative" selected="true"
change="numberValidator.allowNegative = alowNegative.selected"/>
</mx:FormItem>
<mx:FormItem label="Fractional Digits">
<mx:TextInput id="fractionalDigits" text='{numberValidator.fractionalDigits}'
change="numberFormatter.fractionalDigits =
numberValidator.fractionalDigits = Number(fractionalDigits.text)"/>
</mx:FormItem>
<mx:FormItem label="Actual Locale ID Name">
<mx:Text text="{numberValidator.actualLocaleIDName}"/>
</mx:FormItem>
<mx:FormItem label="Input number" >
<mx:HBox>
<mx:TextInput id="inputNumber" />
<mx:Button id="validateBtn" label="Validate" />
</mx:HBox>
</mx:FormItem>
<mx:FormItem label="Example number">
<mx:Text text="{numberFormatter.format(123456789.12)}"/>
</mx:FormItem>
</mx:Form>
</s:Application>
Tue Jun 12 2018, 11:34 AM Z