| Пакет | mx.validators |
| Класс | public class StringValidator |
| Наследование | StringValidator  Validator EventDispatcher Object |
| Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flex 3 |
| Версии среды выполнения: | Flash Player 9, AIR 1.1 |
Показать синтаксис MXML
Скрыть синтаксис MXMLThe <mx:StringValidator> tag
inherits all of the tag attributes of its superclass,
and add the following tag attributes:
<mx:StringValidator
maxLength="NaN"
minLength="NaN"
tooLongError="This string is longer than the maximum allowed length. This must be less than {0} characters long."
tooShortError="This string is shorter than the minimum allowed length. This must be at least {0} characters long."
/>
Общедоступные свойства
| Свойство | Определено | ||
|---|---|---|---|
 | constructor : Object
Ссылка на объект класса или функцию конструктора для данного экземпляра объекта. | Object | |
| enabled : Boolean
Установка этого значения на false помешает выполнению проверки средством проверки. | Validator | |
| listener : Object
Указывает прослушиватель проверки. | Validator | |
| maxLength : Object
Максимальная допустимая для строки длина. | StringValidator | ||
| minLength : Object
Минимальная допустимая для строки длина. | StringValidator | ||
| property : String
Строка с именем свойства для объекта source, содержащего проверяемое значение. | Validator | |
| required : Boolean = true
Значение true указывает на то, что ошибка проверки вызвана отсутствующим или пустым значением. | Validator | |
| requiredFieldError : String
Сообщение об ошибке, если значение отсутствует, а свойство required имеет значение true. | Validator | |
| source : Object
Указывает объект, содержащий проверяемое свойство. | Validator | |
| tooLongError : String
Сообщение об ошибке, если длина строки больше, чем свойство maxLength. | StringValidator | ||
| tooShortError : String
Сообщение об ошибке, если длина строки меньше, чем свойство minLength. | StringValidator | ||
| trigger : IEventDispatcher
Указывает компонент, генерирующий запускающее средство проверки событие. | Validator | |
| triggerEvent : String
Указывает запускающее проверку событие. | Validator | |
Защищенные свойства
Общедоступные методы
| Метод | Определено | ||
|---|---|---|---|
Конструктор. | StringValidator | ||
| addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void
Регистрирует объект прослушивателя события на объекте EventDispatcher для получения прослушивателем уведомления о событии. | EventDispatcher | |
|
Посылает событие в поток событий. | EventDispatcher | |
|
Проверяет, имеет ли объект EventDispatcher прослушиватели, зарегистрированные для определенного типа события. | EventDispatcher | |
|
Показывает, определено ли заданное свойство для объекта. | Object | |
|
Вызывается автоматически компилятором MXML при создании класса Validator с помощью тега MXML. | Validator | |
|
Показывает, есть ли экземпляр класса Object в цепи прототипов объекта, заданного в качестве параметра. | Object | |
|
Показывает наличие заданного свойства и его перечисляемость. | Object | |
|
Удаляет прослушиватель из объекта EventDispatcher. | EventDispatcher | |
|
Задает доступность динамического свойства для операций цикла. | Object | |
|
Возвращает строковое представление этого объекта, отформатированного в соответствии со стандартами, принятыми для данной локали. | Object | |
|
Возвращает строковое представление заданного объекта. | Object | |
|
Выполняет проверку и дополнительно оповещает прослушиватели результата. | Validator | |
| [статические]
Вызывает все средства проверки в массиве validators. | Validator | |
[статические]
Удобный метод для выполнения вызова средства проверки. | StringValidator | ||
|
Возвращает элементарное значение заданного объекта. | Object | |
|
Проверяет, зарегистрирован ли прослушиватель события для указанного типа события с данным объектом EventDispatcher или любым его предшественником. | EventDispatcher | |
Защищенные методы
| Метод | Определено | ||
|---|---|---|---|
|
Настраивает все прослушиватели на события valid и invalid, передаваемые из средства проверки. | Validator | |
[переопределить]
Переопределение метода базового класса doValidation() для проверки строки. | StringValidator | ||
|
Возвращает проверяемый объект. | Validator | |
|
Возвращает ValidationResultEvent из массива результатов ошибки. | Validator | |
|
Возвращает true, если value не имеет значения null. | Validator | |
|
Отключает все прослушиватели для событий valid и invalid, передаваемых из средства проверки. | Validator | |
|
Этот метод вызывается при создании класса Validator и каждый раз при отправке ResourceManager события change для указания изменения локализованных ресурсов сходным образом. | Validator | |
События
Защищенные константы
Сведения о свойстве
maxLength | свойство |
maxLength:Object| Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flex 3 |
| Версии среды выполнения: | Flash Player 9, AIR 1.1 |
Максимальная допустимая для строки длина. Значение NaN означает игнорирование свойства.
Значением по умолчанию является NaN.
Реализация
public function get maxLength():Object public function set maxLength(value:Object):voidminLength | свойство |
minLength:Object| Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flex 3 |
| Версии среды выполнения: | Flash Player 9, AIR 1.1 |
Минимальная допустимая для строки длина. Значение NaN означает игнорирование свойства.
Значением по умолчанию является NaN.
Реализация
public function get minLength():Object public function set minLength(value:Object):voidtooLongError | свойство |
tooLongError:String| Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flex 3 |
| Версии среды выполнения: | Flash Player 9, AIR 1.1 |
Сообщение об ошибке, если длина строки больше, чем свойство maxLength.
Значением по умолчанию является "This string is longer than the maximum allowed length. This must be less than {0} characters long.".
Реализация
public function get tooLongError():String public function set tooLongError(value:String):voidtooShortError | свойство |
tooShortError:String| Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flex 3 |
| Версии среды выполнения: | Flash Player 9, AIR 1.1 |
Сообщение об ошибке, если длина строки меньше, чем свойство minLength.
Значением по умолчанию является "This string is shorter than the minimum allowed length. This must be at least {0} characters long.".
Реализация
public function get tooShortError():String public function set tooShortError(value:String):voidСведения о конструкторе
StringValidator | () | Конструктор |
public function StringValidator()| Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flex 3 |
| Версии среды выполнения: | Flash Player 9, AIR 1.1 |
Конструктор.
Сведения о методе
doValidation | () | метод |
override protected function doValidation(value:Object):Array| Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flex 3 |
| Версии среды выполнения: | Flash Player 9, AIR 1.1 |
Переопределение метода базового класса doValidation() для проверки строки.
Этот метод не вызывается напрямую; Flex вызывает его как часть выполнения проверки. Этот метод необходимо реализовать при создании пользовательского класса Validator.
Параметры
value:Object — Проверяемый объект.
|
Array — Массив объектов ValidationResult с одним объектом ValidationResult для каждого поля, проверенного средством проверки.
|
validateString | () | метод |
public static function validateString(validator:StringValidator, value:Object, baseField:String = null):Array| Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flex 3 |
| Версии среды выполнения: | Flash Player 9, AIR 1.1 |
Удобный метод для выполнения вызова средства проверки. Каждое стандартное средство проверки Flex имеет подобный удобный метод.
Параметры
validator:StringValidator — Экземпляр StringValidator.
| |
value:Object — Проверяемое поле.
| |
baseField:String (default = null)value. Например, если параметр value имеет значение value.mystring, то baseField имеет значение mystring.
|
Array — Массив объектов ValidationResult с одним объектом ValidationResult для каждого поля, проверенного средством проверки.
|
Связанные элементы API
Примеры Использование этого примера
StringValidatorExample.mxml
<?xml version="1.0" encoding="utf-8"?>
<!-- Simple example to demonstrate StringValidator. -->
<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:Script>
import mx.controls.Alert;
</fx:Script>
<fx:Declarations>
<mx:StringValidator source="{fname}" property="text"
tooShortError="This string is shorter than the minimum allowed length of 4. "
tooLongError="This string is longer than the maximum allowed length of 20."
minLength="4" maxLength="20"
trigger="{myButton}" triggerEvent="click"
valid="Alert.show('Validation Succeeded!');"
invalid="Alert.show('Validation Failed!');"/>
</fx:Declarations>
<s:Panel title="StringValidator Example"
width="75%" height="75%"
horizontalCenter="0" verticalCenter="0">
<mx:Form left="10" right="10" top="10" bottom="10">
<mx:FormItem label="Enter a name between 4 and 20 characters: ">
<s:TextInput id="fname" width="100%"/>
</mx:FormItem>
<mx:FormItem >
<s:Button id="myButton" label="Validate" />
</mx:FormItem>
</mx:Form>
</s:Panel>
</s:Application>
Tue Jun 12 2018, 11:34 AM Z