Справочник по ActionScript® 3.0 для платформы Adobe® Flash®
Домашняя страница  |  Скрыть список пакетов и классов |  Пакеты  |  Классы  |  Что нового  |  Указатель  |  Приложения  |  Почему по-английски?
Фильтры: Получение данных с сервера...
Получение данных с сервера...
spark.validators.supportClasses 

GlobalizationValidatorBase  - AS3 Flex

Пакетspark.validators.supportClasses
Классpublic class GlobalizationValidatorBase
НаследованиеGlobalizationValidatorBase Inheritance GlobalizationBase Inheritance AdvancedStyleClient Inheritance EventDispatcher Inheritance Object
Реализует IValidator
Подклассы NumberValidatorBase

Язык версии: ActionScript 3.0
Версия продукта: Flex 4.5
Версии среды выполнения: Flash Player 10.1, AIR 2.5

Класс GlobalizationValidatorBase является базовым классом для всех средств проверки Spark. В этом классе реализуется возможность средства проверки создавать требуемое поле, т. е. пользователь должен ввести значение в поле, иначе проверка даст сбой. Этот класс также включает и выключает средство проверки.

Синтаксис MXMLexpandedСкрыть синтаксис MXML

The <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



Общедоступные свойства
 СвойствоОпределено
 InheritedactualLocaleIDName : String
[только для чтения] Имя фактического идентификатора локали, используемое этим объектом класса.
GlobalizationBase
 InheritedclassName : String
[только для чтения] Имя класса компонента.
AdvancedStyleClient
 Inheritedconstructor : Object
Ссылка на объект класса или функцию конструктора для данного экземпляра объекта.
Object
  enabled : Boolean
Установка этого значения на false помешает выполнению проверки средством проверки.
GlobalizationValidatorBase
 Inheritedid : String
Идентификатор компонента.
AdvancedStyleClient
 InheritedinheritingStyles : Object
Объект, содержащий стили наследования для экземпляра клиента с невизуальным стилем.
AdvancedStyleClient
 InheritedlastOperationStatus : String
[только для чтения] Состояние самой последней операции, выполненной этим объектом класса.
GlobalizationBase
  listener : Object
Указывает прослушиватель проверки.
GlobalizationValidatorBase
 InheritedmoduleFactory : IFlexModuleFactory
Фабрика модуля, используемая в качестве контекста для поиска менеджера стилей, управляющего стилями в этом экземпляре клиента с невизуальным стилем.
AdvancedStyleClient
 InheritednonInheritingStyles : Object
Начало цепочки этого компонента с ненаследуемыми стилями.
AdvancedStyleClient
  property : String
Строка с именем свойства для объекта source, содержащего проверяемое значение.
GlobalizationValidatorBase
  required : Boolean = true
Значение true указывает на то, что ошибка проверки вызвана отсутствующим или пустым значением.
GlobalizationValidatorBase
  requiredFieldError : String
Сообщение об ошибке, если значение отсутствует, а свойство required имеет значение true.
GlobalizationValidatorBase
  source : Object
Указывает объект, содержащий проверяемое свойство.
GlobalizationValidatorBase
 InheritedstyleDeclaration : CSSStyleDeclaration
Объявление стиля, которое содержит действующие стили, объявленные этим объектом.
AdvancedStyleClient
 InheritedstyleManager : IStyleManager2
[только для чтения] Возвращает экземпляр StyleManager, используемый этим компонентом.
AdvancedStyleClient
 InheritedstyleName : Object
Источник значений стиля данного объекта.
AdvancedStyleClient
 InheritedstyleParent : IAdvancedStyleClient
Вышестоящий узел компонента используется для анализа нижестоящих селекторов.
AdvancedStyleClient
  trigger : IEventDispatcher
Указывает компонент, генерирующий запускающее средство проверки событие.
GlobalizationValidatorBase
  triggerEvent : String
Указывает запускающее проверку событие.
GlobalizationValidatorBase
Защищенные свойства
 СвойствоОпределено
  actualListeners : Array
[только для чтения] Содержит массив объектов прослушивателей при их наличии или исходный объект.
GlobalizationValidatorBase
  actualTrigger : IEventDispatcher
[только для чтения] Содержит объект-триггер при его наличии или исходный объект.
GlobalizationValidatorBase
  resourceManager : IResourceManager
[только для чтения] Ссылка на объект, управляющий всеми локализованными ресурсами приложения.
GlobalizationValidatorBase
  subFields : Array
Массив строк, содержащий имена свойств из объекта value, переданного в метод validate().
GlobalizationValidatorBase
Общедоступные методы
 МетодОпределено
  
Конструктор.
GlobalizationValidatorBase
 Inherited
addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void
Регистрирует объект прослушивателя события на объекте EventDispatcher для получения прослушивателем уведомления о событии.
EventDispatcher
 Inherited
Удаляет свойство style для экземпляра компонента.
AdvancedStyleClient
 Inherited
Посылает событие в поток событий.
EventDispatcher
 Inherited
Возвращает массив объектов CSSStyleDeclaration для селектора типа, применяемого к этому компоненту, или null, если массив не существует.
AdvancedStyleClient
 Inherited
getStyle(styleProp:String):*
[переопределить] Получает свойство style, которое было установлено в любом месте в пределах цепочки поиска стиля этого компонента.
GlobalizationBase
 Inherited
Возвращает true, если для currentCSSState не указано значение null.
AdvancedStyleClient
 Inherited
Проверяет, имеет ли объект EventDispatcher прослушиватели, зарегистрированные для определенного типа события.
EventDispatcher
 Inherited
Показывает, определено ли заданное свойство для объекта.
Object
 Inherited
Инициализированный метод вызывается, когда этот класс или класс, расширяющий этот класс, используются в объявлении MXML.
AdvancedStyleClient
 Inherited
Показывает, есть ли экземпляр класса Object в цепи прототипов объекта, заданного в качестве параметра.
Object
 Inherited
Возвращает значение true, если cssState совпадает с currentCSSState.
AdvancedStyleClient
 Inherited
Определяет, совпадает ли этот экземпляр с данным типом (или является его подклассом).
AdvancedStyleClient
 Inherited
Применяет изменения стиля к нижестоящим элементам этого экземпляра клиента стиля.
AdvancedStyleClient
 Inherited
Показывает наличие заданного свойства и его перечисляемость.
Object
 Inherited
Обеспечивает настройку внутренних значений кэша стиля для функционирования метода getStyle().
AdvancedStyleClient
 Inherited
Обеспечивает регистрацию EffectManager в качестве одного из прослушивателей события для каждого события эффекта.
AdvancedStyleClient
 Inherited
removeEventListener(type:String, listener:Function, useCapture:Boolean = false):void
Удаляет прослушиватель из объекта EventDispatcher.
EventDispatcher
 Inherited
Задает доступность динамического свойства для операций цикла.
Object
 Inherited
setStyle(styleProp:String, newValue:*):void
Задает свойство style для экземпляра компонента.
AdvancedStyleClient
 Inherited
Обеспечивает обнаружение изменений в свойствах стиля.
AdvancedStyleClient
 Inherited
Метод stylesInitialized() вызывается программой Flex при первой инициализации стиля компонента.
AdvancedStyleClient
 Inherited
Возвращает строковое представление этого объекта, отформатированного в соответствии со стандартами, принятыми для данной локали.
Object
 Inherited
Возвращает строковое представление заданного объекта.
Object
  
validate(value:Object = null, suppressEvents:Boolean = false):ValidationResultEvent
Выполняет проверку и дополнительно оповещает прослушиватели результата.
GlobalizationValidatorBase
  
validateAll(validators:Array):Array
[статические] Вызывает все средства проверки в массиве validators.
GlobalizationValidatorBase
 Inherited
Возвращает элементарное значение заданного объекта.
Object
 Inherited
Проверяет, зарегистрирован ли прослушиватель события для указанного типа события с данным объектом EventDispatcher или любым его предшественником.
EventDispatcher
Защищенные методы
 МетодОпределено
  
Настраивает все прослушиватели на события valid и invalid, передаваемые из средства проверки.
GlobalizationValidatorBase
  
Выполняет логику проверки этого средства проверки, включая проверку ошибки из-за отсутствующего или пустого значения, определяемую значением свойства required.
GlobalizationValidatorBase
  
Возвращает проверяемый объект.
GlobalizationValidatorBase
  
Возвращает ValidationResultEvent из массива результатов ошибки.
GlobalizationValidatorBase
  
Возвращает true, если value не имеет значения null.
GlobalizationValidatorBase
  
Отключает все прослушиватели для событий valid и invalid, передаваемых из средства проверки.
GlobalizationValidatorBase
  
Этот метод вызывается при создании класса GlobalizationValidatorBase и далее при каждой передаче диспетчером ResourceManager события "change" для указания изменений локализованных ресурсов.
GlobalizationValidatorBase
События
 Событие Сводка Определено
 Inherited[многоадресное событие] Отправляется, когда проигрыватель Flash Player или приложение AIR перемещается в фокус операционной системы и становится активным.EventDispatcher
 InheritedСобытие изменения создается при изменении стиля локали или установке другого свойства, которое изменит формат числа или обновит другие значения, доступные с помощью этого класса.GlobalizationBase
 Inherited[многоадресное событие] Отправляется, когда проигрыватель Flash Player или приложение AIR теряет фокус системы и становится неактивным.EventDispatcher
  Передается при сбое проверки.GlobalizationValidatorBase
  Передается при успешном завершении проверки.GlobalizationValidatorBase
Стили

Стили являются либо общими, либо связанными с определенной темой. Если стиль общий, он может использоваться с любой темой. Если стиль связан с определенной темой, он может использоваться, только если ваше приложение использует ее.

Общие стили
 Стиль Описание Определено
 InheritedТип: String Наследование CSS: Да
Язык версии: ActionScript 3.0  Версия продукта: Flex 4.5  Версии среды выполнения: Flash10.1, AIR 2.5

Идентификатор локали, который определяет язык, область, сценарий и, дополнительно, другие связанные теги и ключи.
GlobalizationBase
Сведения о свойстве

actualListeners

свойство
actualListeners:Array  [только для чтения]

Язык версии: ActionScript 3.0
Версия продукта: Flex 4.5
Версии среды выполнения: Flash Player 10.1, AIR 2.5

Содержит массив объектов прослушивателей при их наличии или исходный объект. Используется для определения объекта, который необходимо оповестить о результате проверки.



Реализация
    protected function get actualListeners():Array

actualTrigger

свойство 
actualTrigger:IEventDispatcher  [только для чтения]

Язык версии: ActionScript 3.0
Версия продукта: Flex 4.5
Версии среды выполнения: Flash Player 10.1, AIR 2.5

Содержит объект-триггер при его наличии или исходный объект. Используется для определения объекта прослушивателя для triggerEvent.



Реализация
    protected function get actualTrigger():IEventDispatcher

enabled

свойство 
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):void

listener

свойство 
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):void

property

свойство 
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):void

required

свойство 
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):void

resourceManager

свойство 
resourceManager:IResourceManager  [только для чтения]

Язык версии: ActionScript 3.0
Версия продукта: Flex 4.5
Версии среды выполнения: Flash Player 10.1, AIR 2.5

Ссылка на объект, управляющий всеми локализованными ресурсами приложения. Это одиночный экземпляр единичного предмета, реализующий интерфейс IResourceManager.

Это свойство можно использовать в качестве источника для связывания данных. При изменении этого свойства отправляется событие unused .



Реализация
    protected function get resourceManager():IResourceManager

source

свойство 
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):void

subFields

свойство 
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):void

triggerEvent

свойство 
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):void
Сведения о конструкторе

GlobalizationValidatorBase

()Конструктор
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

()метод 
protected function getValueFromSource():Object

Язык версии: ActionScript 3.0
Версия продукта: Flex 4.5
Версии среды выполнения: Flash Player 10.1, AIR 2.5

Возвращает проверяемый объект.

Возвращает
Object — Проверяемый объект.

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 — Тестируемое значение.

Возвращает
Booleantrue, если 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) — Необязательное проверяемое значение. Если 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.

Свойства объекта события имеют следующие значения:

СвойствоЗначение
bubblesfalse
cancelablefalse
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.

Свойства объекта события имеют следующие значения:

СвойствоЗначение
bubblesfalse
cancelablefalse
currentTargetОбъект, определяющий прослушиватель события, который выполняет обработку события. Например, если используется myButton.addEventListener() для регистрации прослушивателя события, значением currentTarget является myButton.
fieldПустая строка.
messageПустая строка.
resultsПустой массив.
targetОбъект, отправивший событие. Это не всегда тот объект, который прослушивает событие. Свойство currentTarget всегда используется для получения доступа к объекту, прослушивающему событие.




[ X ]Почему по-английски?
Содержимое Справочника ActionScript 3.0 отображается на английском языке

Не все части Справочника ActionScript 3.0 переводятся на все языки. Если какой-то текстовый элемент не переведен, он отображается на английском языке. Например, компонент ga.controls.HelpBox не переведен ни на один из языков. Это значит, что в русской версии справки компонент ga.controls.HelpBox будет отображаться на английском языке.