| Пакет | mx.formatters |
| Класс | public class ZipCodeFormatter |
| Наследование | ZipCodeFormatter  Formatter Object |
| Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flex 3 |
| Версии среды выполнения: | Flash Player 9, AIR 1.1 |
formatString.
- #####-####
- ##### ####
- #####
- ### ### (Канада)
Для шестизначной маски должен вводиться шестизначный номер. При использовании пятизначной или девятизначной маски для форматирования допускается пятизначный или девятизначный номер.
В случае ошибки возвращается пустая строка, а строка с описанием ошибки сохраняется в свойстве error. Свойство error может иметь одно из следующих значений:
-
Invalid valueозначает, что методуformat()было передано недопустимое числовое значение. Значение должно являться допустимым числом в виде номера или строки, за исключением почтового индекса для Канады, в котором допускаются буквенно-цифровые значения. При несоответствии количества цифр допустимому количеству из свойстваformatStringзначение считается недопустимым. -
Invalid formatозначает, что какой-либо символ в свойствеformatStringне соответствует допустимым символам, указанным в свойствеvalidFormatChars, либо количество числовых заполнителей не равно 9, 5 или 6.
Показать синтаксис MXML
Скрыть синтаксис MXMLThe <mx:ZipCodeFormatter> tag
inherits all of the tag attributes of its superclass,
and adds the following tag attributes:
<mx:ZipCodeFormatter
formatString="#####|#####-####|### ###"
/>
Связанные элементы API
Общедоступные свойства
| Свойство | Определено | ||
|---|---|---|---|
 | constructor : Object
Ссылка на объект класса или функцию конструктора для данного экземпляра объекта. | Object | |
| error : String
Описание, сохраняемое средством форматирования при появлении ошибки. | Formatter | |
| formatString : String
Образец маски. | ZipCodeFormatter | ||
Защищенные свойства
Общедоступные методы
| Метод | Определено | ||
|---|---|---|---|
Конструктор. | ZipCodeFormatter | ||
[переопределить]
Форматирует строку с использованием указанного формата. | ZipCodeFormatter | ||
|
Показывает, определено ли заданное свойство для объекта. | Object | |
|
Показывает, есть ли экземпляр класса Object в цепи прототипов объекта, заданного в качестве параметра. | Object | |
|
Показывает наличие заданного свойства и его перечисляемость. | Object | |
|
Задает доступность динамического свойства для операций цикла. | Object | |
|
Возвращает строковое представление этого объекта, отформатированного в соответствии со стандартами, принятыми для данной локали. | Object | |
|
Возвращает строковое представление заданного объекта. | Object | |
|
Возвращает элементарное значение заданного объекта. | Object | |
Сведения о свойстве
formatString | свойство |
formatString:String| Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flex 3 |
| Версии среды выполнения: | Flash Player 9, AIR 1.1 |
Образец маски. Возможными значениями являются #####-####, ##### ####, #####, ###-### и ### ###.
Значением по умолчанию является "#####".
Реализация
public function get formatString():String public function set formatString(value:String):voidСведения о конструкторе
ZipCodeFormatter | () | Конструктор |
public function ZipCodeFormatter()| Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flex 3 |
| Версии среды выполнения: | Flash Player 9, AIR 1.1 |
Конструктор.
Сведения о методе
format | () | метод |
override public function format(value:Object):String| Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flex 3 |
| Версии среды выполнения: | Flash Player 9, AIR 1.1 |
Форматирует строку с использованием указанного формата. Если отформатировать значение невозможно, возвращается пустая строка, и описание ошибки записывается в свойство error.
Параметры
value:Object — Значение для форматирования.
|
String — Отформатированная строка. В случае ошибки эта строка будет пустой. Описание состояния ошибки записывается в свойство error.
|
Примеры Использование этого примера
ZipCodeFormatterExample.mxml
<?xml version="1.0" encoding="utf-8"?>
<!-- Simple example to demonstrate ZipCodeFormatter. -->
<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>
<![CDATA[
import mx.events.ValidationResultEvent;
private var vResult:ValidationResultEvent;
// Event handler to validate and format input.
private function Format():void {
vResult = zcVal.validate();
if (vResult.type == ValidationResultEvent.VALID) {
formattedZipcode.text = zipFormatter.format(zip.text);
} else {
formattedZipcode.text = "";
}
}
]]>
</fx:Script>
<fx:Declarations>
<mx:ZipCodeFormatter id="zipFormatter" formatString="#####-####"/>
<mx:ZipCodeValidator id="zcVal" source="{zip}" property="text" allowedFormatChars=""/>
</fx:Declarations>
<s:Panel title="ZipCodeFormatter Example"
width="75%" height="75%"
horizontalCenter="0" verticalCenter="0">
<mx:Form left="10" right="10" top="10" bottom="10">
<mx:FormItem label="Enter a 5 or 9 digit U.S. ZIP code:" width="100%">
<s:TextInput id="zip" text=""/>
</mx:FormItem>
<mx:FormItem label="Formatted ZIP code: " width="100%">
<s:TextInput id="formattedZipcode" text="" editable="false"/>
</mx:FormItem>
<mx:FormItem>
<s:Button label="Validate and Format" click="Format();"/>
</mx:FormItem>
</mx:Form>
</s:Panel>
</s:Application>
Tue Jun 12 2018, 11:34 AM Z