| Пакет | spark.validators.supportClasses |
| Класс | public class GlobalizationValidatorBase |
| Наследование | GlobalizationValidatorBase  GlobalizationBase AdvancedStyleClient EventDispatcher Object |
| Реализует | IValidator |
| Подклассы | NumberValidatorBase |
| Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flex 4.5 |
| Версии среды выполнения: | Flash Player 10.1, AIR 2.5 |
Показать синтаксис MXML
Скрыть синтаксис MXMLThe <s:GlobalizationValidatorBase> tag
inherits all of the tag attributes of its superclass,
and adds the following tag attributes:
<s:GlobalizationValidatorBase
Properties
enabled="true"
listener="Value of the source property"
property="No default"
required="true"
requiredFieldError="This field is required."
source="No default"
trigger="Value of the source property"
triggerEvent="valueCommit"
Events
invalid="No default"
valid="No default"
/>
Связанные элементы API
| Свойство | Определено | ||
|---|---|---|---|
 | actualLocaleIDName : String [только для чтения]
Имя фактического идентификатора локали, используемое этим объектом класса. | GlobalizationBase | |
| className : String [только для чтения]
Имя класса компонента. | AdvancedStyleClient | |
| constructor : Object
Ссылка на объект класса или функцию конструктора для данного экземпляра объекта. | Object | |
| enabled : Boolean
Установка этого значения на false помешает выполнению проверки средством проверки. | GlobalizationValidatorBase | ||
| id : String
Идентификатор компонента. | AdvancedStyleClient | |
| inheritingStyles : Object
Объект, содержащий стили наследования для экземпляра клиента с невизуальным стилем. | AdvancedStyleClient | |
| lastOperationStatus : String [только для чтения]
Состояние самой последней операции, выполненной этим объектом класса. | GlobalizationBase | |
| listener : Object
Указывает прослушиватель проверки. | GlobalizationValidatorBase | ||
| moduleFactory : IFlexModuleFactory
Фабрика модуля, используемая в качестве контекста для поиска менеджера стилей, управляющего стилями в этом экземпляре клиента с невизуальным стилем. | AdvancedStyleClient | |
| nonInheritingStyles : Object
Начало цепочки этого компонента с ненаследуемыми стилями. | AdvancedStyleClient | |
| 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 | ||
| Свойство | Определено | ||
|---|---|---|---|
| actualListeners : Array [только для чтения]
Содержит массив объектов прослушивателей при их наличии или исходный объект. | GlobalizationValidatorBase | ||
| actualTrigger : IEventDispatcher [только для чтения]
Содержит объект-триггер при его наличии или исходный объект. | GlobalizationValidatorBase | ||
| resourceManager : IResourceManager [только для чтения]
Ссылка на объект, управляющий всеми локализованными ресурсами приложения. | GlobalizationValidatorBase | ||
| subFields : Array
Массив строк, содержащий имена свойств из объекта value, переданного в метод validate(). | GlobalizationValidatorBase | ||
| Метод | Определено | ||
|---|---|---|---|
Конструктор. | GlobalizationValidatorBase | ||
| 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 | ||
|
Возвращает элементарное значение заданного объекта. | Object | |
|
Проверяет, зарегистрирован ли прослушиватель события для указанного типа события с данным объектом EventDispatcher или любым его предшественником. | EventDispatcher | |
| Метод | Определено | ||
|---|---|---|---|
Настраивает все прослушиватели на события valid и invalid, передаваемые из средства проверки. | GlobalizationValidatorBase | ||
Выполняет логику проверки этого средства проверки, включая проверку ошибки из-за отсутствующего или пустого значения, определяемую значением свойства required. | GlobalizationValidatorBase | ||
Возвращает проверяемый объект. | GlobalizationValidatorBase | ||
Возвращает ValidationResultEvent из массива результатов ошибки. | GlobalizationValidatorBase | ||
Возвращает true, если value не имеет значения null. | GlobalizationValidatorBase | ||
Отключает все прослушиватели для событий valid и invalid, передаваемых из средства проверки. | GlobalizationValidatorBase | ||
Этот метод вызывается при создании класса GlobalizationValidatorBase и далее при каждой передаче диспетчером ResourceManager события "change" для указания изменений локализованных ресурсов. | GlobalizationValidatorBase | ||
| Событие | Сводка | Определено | ||
|---|---|---|---|---|
| [многоадресное событие] Отправляется, когда проигрыватель Flash Player или приложение AIR перемещается в фокус операционной системы и становится активным. | EventDispatcher | ||
| Событие изменения создается при изменении стиля локали или установке другого свойства, которое изменит формат числа или обновит другие значения, доступные с помощью этого класса. | GlobalizationBase | ||
| [многоадресное событие] Отправляется, когда проигрыватель Flash Player или приложение AIR теряет фокус системы и становится неактивным. | EventDispatcher | ||
| Передается при сбое проверки. | GlobalizationValidatorBase | |||
| Передается при успешном завершении проверки. | GlobalizationValidatorBase | |||
Стили являются либо общими, либо связанными с определенной темой. Если стиль общий, он может использоваться с любой темой. Если стиль связан с определенной темой, он может использоваться, только если ваше приложение использует ее.
actualListeners | свойство |
actualListeners:Array [только для чтения] | Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flex 4.5 |
| Версии среды выполнения: | Flash Player 10.1, AIR 2.5 |
Содержит массив объектов прослушивателей при их наличии или исходный объект. Используется для определения объекта, который необходимо оповестить о результате проверки.
Реализация
protected function get actualListeners():ArrayactualTrigger | свойство |
actualTrigger:IEventDispatcher [только для чтения] | Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flex 4.5 |
| Версии среды выполнения: | Flash Player 10.1, AIR 2.5 |
Содержит объект-триггер при его наличии или исходный объект. Используется для определения объекта прослушивателя для triggerEvent.
Реализация
protected function get actualTrigger():IEventDispatcherenabled | свойство |
enabled:Boolean| Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flex 4.5 |
| Версии среды выполнения: | Flash Player 10.1, AIR 2.5 |
Установка этого значения на false помешает выполнению проверки средством проверки. Если средство проверки отключено, оно не передает события, а метод validate() возвращает значение null.
Значением по умолчанию является true.
Реализация
public function get enabled():Boolean public function set enabled(value:Boolean):voidlistener | свойство |
listener:Object| Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flex 4.5 |
| Версии среды выполнения: | Flash Player 10.1, AIR 2.5 |
Указывает прослушиватель проверки.
Если прослушиватель не указан, Flex использует значение свойства source. После определения Flex исходного компонента изменяется цвет границы компонента, появляется сообщение об ошибке в результате сбоя или скрывается любое существующее сообщение об успешной проверке.
Реализация
public function get listener():Object public function set listener(value:Object):voidproperty | свойство |
property:String| Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flex 4.5 |
| Версии среды выполнения: | Flash Player 10.1, AIR 2.5 |
Строка с именем свойства для объекта source, содержащего проверяемое значение. Это свойство является необязательным, но при указании source требуется также установить значение для этого свойства.
Значением по умолчанию является null.
Реализация
public function get property():String public function set property(value:String):voidrequired | свойство |
public var required:Boolean = true| Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flex 4.5 |
| Версии среды выполнения: | Flash Player 10.1, AIR 2.5 |
Значение true указывает на то, что ошибка проверки вызвана отсутствующим или пустым значением.
Значением по умолчанию является true.
requiredFieldError | свойство |
requiredFieldError:String| Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flex 4.5 |
| Версии среды выполнения: | Flash Player 10.1, AIR 2.5 |
Сообщение об ошибке, если значение отсутствует, а свойство required имеет значение true.
Значением по умолчанию является "This field is required.".
Реализация
public function get requiredFieldError():String public function set requiredFieldError(value:String):voidresourceManager | свойство |
resourceManager:IResourceManager [только для чтения] | Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flex 4.5 |
| Версии среды выполнения: | Flash Player 10.1, AIR 2.5 |
Ссылка на объект, управляющий всеми локализованными ресурсами приложения. Это одиночный экземпляр единичного предмета, реализующий интерфейс IResourceManager.
Это свойство можно использовать в качестве источника для связывания данных. При изменении этого свойства отправляется событие unused .
Реализация
protected function get resourceManager():IResourceManagersource | свойство |
source:Object| Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flex 4.5 |
| Версии среды выполнения: | Flash Player 10.1, AIR 2.5 |
Указывает объект, содержащий проверяемое свойство. Определяет данный элемент как экземпляр компонента или модель данных. Синтаксис связывания данных в MXML используется для определения значения. Это свойство поддерживает разделенные точкой строки для определения вложенных свойств. Если указано значение свойства source, требуется также определить значение свойства property. Свойство source является необязательным.
Значением по умолчанию является null.
Реализация
public function get source():Object public function set source(value:Object):voidsubFields | свойство |
protected var subFields:Array| Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flex 4.5 |
| Версии среды выполнения: | Flash Player 10.1, AIR 2.5 |
Массив строк, содержащий имена свойств из объекта value, переданного в метод validate(). Например, CreditCardValidator определяет это свойство значениями [ "cardNumber", "cardType" ]. Это значение означает, что объект value, передаваемый в метод validate() должен содержать свойство cardNumber и cardType.
trigger | свойство |
trigger:IEventDispatcher| Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flex 4.5 |
| Версии среды выполнения: | Flash Player 10.1, AIR 2.5 |
Указывает компонент, генерирующий запускающее средство проверки событие. Если он опущен, по умолчанию Flex использует значение свойства source. Если trigger передает triggerEvent, проверка выполняется.
Реализация
public function get trigger():IEventDispatcher public function set trigger(value:IEventDispatcher):voidtriggerEvent | свойство |
triggerEvent:String| Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flex 4.5 |
| Версии среды выполнения: | Flash Player 10.1, AIR 2.5 |
Указывает запускающее проверку событие. Если оно опущено, Flex использует событие valueCommit. Flex передает событие valueCommit, если пользователь выполняет ввод данных в элемент управления. Обычно происходит при удалении пользователем фокуса из компонента или при программном изменении значения свойства. При необходимости игнорирования средством проверки всех событий установите triggerEvent как пустую строку ("").
Реализация
public function get triggerEvent():String public function set triggerEvent(value:String):voidGlobalizationValidatorBase | () | Конструктор |
public function GlobalizationValidatorBase()| Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flex 4.5 |
| Версии среды выполнения: | Flash Player 10.1, AIR 2.5 |
Конструктор.
addListenerHandler | () | метод |
protected function addListenerHandler():void| Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flex 4.5 |
| Версии среды выполнения: | Flash Player 10.1, AIR 2.5 |
Настраивает все прослушиватели на события valid и invalid, передаваемые из средства проверки. Подклассы класса GlobalizationValidatorBase должны сначала вызвать метод removeListenerHandler(), а затем метод addListenerHandler(), если изменяется значение одного из прослушивателей или источников. Классы CreditCardValidator и DateValidator используют эту функцию на внутреннем уровне.
doValidation | () | метод |
protected function doValidation(value:Object):Array| Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flex 4.5 |
| Версии среды выполнения: | Flash Player 10.1, AIR 2.5 |
Выполняет логику проверки этого средства проверки, включая проверку ошибки из-за отсутствующего или пустого значения, определяемую значением свойства required.
При создании подкласса класса Validator следует переопределить этот метод.
Параметры
value:Object — Проверяемое значение.
|
Array — Для недопустимого результата массив объектов ValidationResult с одним объектом ValidationResult для каждого поля, проверенного средством проверки со сбоем.
|
Связанные элементы API
getValueFromSource | () | метод |
handleResults | () | метод |
protected function handleResults(errorResults:Array):ValidationResultEvent| Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flex 4.5 |
| Версии среды выполнения: | Flash Player 10.1, AIR 2.5 |
Возвращает ValidationResultEvent из массива результатов ошибки. Внутренне эта функция принимает результаты из метода doValidation() и помещает их в объект ValidationResultEvent. Данная функция никогда не вызывается напрямую, поэтому частое переопределение функции не требуется.
Параметры
errorResults:Array — Массив объектов ValidationResult.
|
ValidationResultEvent — ValidationResultEvent, возвращенный с помощью метода validate().
|
isRealValue | () | метод |
protected function isRealValue(value:Object):Boolean| Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flex 4.5 |
| Версии среды выполнения: | Flash Player 10.1, AIR 2.5 |
Возвращает true, если value не имеет значения null.
Параметры
value:Object — Тестируемое значение.
|
Boolean — true, если value не имеет значение null.
|
removeListenerHandler | () | метод |
protected function removeListenerHandler():void| Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flex 4.5 |
| Версии среды выполнения: | Flash Player 10.1, AIR 2.5 |
Отключает все прослушиватели для событий valid и invalid, передаваемых из средства проверки. Подклассы должны сначала вызывать метод removeListenerHandler(), а затем метод addListenerHandler при изменении значения одного из прослушивателей или источников. Классы CreditCardValidator и DateValidator используют эту функцию на внутреннем уровне.
resourcesChanged | () | метод |
protected function resourcesChanged():void| Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flex 4.5 |
| Версии среды выполнения: | Flash Player 10.1, AIR 2.5 |
Этот метод вызывается при создании класса GlobalizationValidatorBase и далее при каждой передаче диспетчером ResourceManager события "change" для указания изменений локализованных ресурсов.
Это событие передается при установке значения для свойства ResourceManager localeChain после завершения загрузки модуля ресурсов и при вызове метода ResourceManager update().
Подклассы должны отменять этот метод и после вызова super.resourcesChanged() выполнять соответствующую операцию в ответ на получение новых значений ресурсов.
validate | () | метод |
public function validate(value:Object = null, suppressEvents:Boolean = false):ValidationResultEvent| Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flex 4.5 |
| Версии среды выполнения: | Flash Player 10.1, AIR 2.5 |
Выполняет проверку и дополнительно оповещает прослушиватели результата.
Параметры
value:Object (default = null)source и property для определения значения. При определении этого аргумента следует также настроить свойство listener для определения целевого компонента любых сообщений об ошибках, возникающих при проверке.
| |
suppressEvents:Boolean (default = false)false, после проверки средство проверки оповещает прослушиватель результата.
|
ValidationResultEvent — Объект ValidationResultEvent, содержащий результаты проверки. В случае успешной проверки свойство массива ValidationResultEvent.results является пустым. В случае сбоя проверки свойство массива ValidationResultEvent.results содержит по одному объекту ValidationResult для каждого поля, проверяемого средством проверки, как для не прошедших, так и для прошедших проверку полей. Проверьте свойство ValidationResult.isError для определения успешного выполнения или сбоя проверки поля.
|
Связанные элементы API
validateAll | () | метод |
public static function validateAll(validators:Array):Array| Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flex 4.5 |
| Версии среды выполнения: | Flash Player 10.1, AIR 2.5 |
Вызывает все средства проверки в массиве validators. Возвращает массив, содержащий по одному объекту ValidationResultEvent на каждое средство проверки, выполненное с ошибкой. Возвращает пустой массив, если все средства проверки выполнены успешно.
Параметры
validators:Array — Массив, содержащий выполняемые объекты класса GlobalizationValidatorBase.
|
Array — Массив объектов ValidationResultEvent, где массив содержит по одному объекту ValidationResultEvent на каждое средство проверки, выполненное с ошибкой. Массив пуст, если все средства проверки были выполнены успешно.
|
invalid | Событие |
mx.events.ValidationResultEventсвойство ValidationResultEvent.type =
mx.events.ValidationResultEvent.INVALID| Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flex 4.5 |
| Версии среды выполнения: | Flash Player 10.1, AIR 2.5 |
Передается при сбое проверки.
КонстантаValidationResultEvent.INVALID определяет значение свойства type объекта события invalid. Эта константа имеет значение invalid.
Свойства объекта события имеют следующие значения:
| Свойство | Значение |
|---|---|
bubbles | false |
cancelable | false |
currentTarget | Объект, определяющий прослушиватель события, который выполняет обработку события. Например, если используется myButton.addEventListener() для регистрации прослушивателя события, значением currentTarget является myButton. |
field | Имя поля, не прошедшего проверку правильности. |
message | Отдельная строка в массиве результатов, содержащая сообщение об ошибке из любого объекта ValidationResult. |
results | Массив объектов ValidationResult, по одному объекту на проверяемое поле. |
target | Объект, отправивший событие. Это не всегда тот объект, который прослушивает событие. Свойство currentTarget всегда используется для получения доступа к объекту, прослушивающему событие. |
valid | Событие |
mx.events.ValidationResultEventсвойство ValidationResultEvent.type =
mx.events.ValidationResultEvent.VALID| Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flex 4.5 |
| Версии среды выполнения: | Flash Player 10.1, AIR 2.5 |
Передается при успешном завершении проверки.
КонстантаValidationResultEvent.VALID определяет значение свойства type объекта события valid. Эта константа имеет значение valid.
Свойства объекта события имеют следующие значения:
| Свойство | Значение |
|---|---|
bubbles | false |
cancelable | false |
currentTarget | Объект, определяющий прослушиватель события, который выполняет обработку события. Например, если используется myButton.addEventListener() для регистрации прослушивателя события, значением currentTarget является myButton. |
field | Пустая строка. |
message | Пустая строка. |
results | Пустой массив. |
target | Объект, отправивший событие. Это не всегда тот объект, который прослушивает событие. Свойство currentTarget всегда используется для получения доступа к объекту, прослушивающему событие. |
Tue Jun 12 2018, 11:34 AM Z