| Paket | mx.formatters |
| Klasse | public class ZipCodeFormatter |
| Vererbung | ZipCodeFormatter  Formatter Object |
| Sprachversion: | ActionScript 3.0 |
| Produktversion: | Flex 3 |
| Laufzeitversionen: | Flash Player 9, AIR 1.1 |
formatString-Eigenschaft eine gültige Zahl in eines der folgenden Formate.
- #####-####
- ##### ####
- #####
- ### ### (Kanada)
Eine sechsstellige Zahl muss für eine sechsstellige Maske zur Verfügung gestellt werden. Wenn Sie eine fünfstellige oder neunstellige Maske verwenden, können Sie entweder eine fünfstellige oder neunstellige Zahl für die Formatierung verwenden.
Wenn ein Fehler aufgetreten ist, wird ein leerer String zurückgegeben und ein den Fehler beschreibender String wird in der Eigenschaft error gespeichert. Die Eigenschaft error kann einen der folgenden Werte aufweisen:
-
"Invalid value"bedeutet, ein numerischer Wert wird an dieformat()-Methode übergeben. Der Wert sollte eine gültige Zahl im Format einer Zahl oder eines Strings sein (mit Ausnahme der Postleitzahl von Kanada, bei der alphanumerische Werte zulässig sind) oder die Anzahl der Stellen stimmt nicht mit den zulässigen Stellen der EigenschaftformatStringüberein. -
"Invalid format"bedeutet, dass die Zeichen der EigenschaftformatStringnicht mit den zulässigen Zeichen der EigenschaftvalidFormatCharsübereinstimmen oder die Anzahl der numerischen Platzhalter nicht 9, 5 oder 6 entspricht.
MXML-Syntax anzeigen
MXML-Syntax ausblendenThe <mx:ZipCodeFormatter> tag
inherits all of the tag attributes of its superclass,
and adds the following tag attributes:
<mx:ZipCodeFormatter
formatString="#####|#####-####|### ###"
/>
Verwandte API-Elemente
Öffentliche Eigenschaften
| Eigenschaft | Definiert von | ||
|---|---|---|---|
 | constructor : Object
Ein Verweis auf das Klassenobjekt oder die Konstruktorfunktion für eine angegebene Objektinstanz. | Object | |
| error : String
Beschreibung, die von der Formatierung gespeichert wird, wenn ein Fehler auftritt. | Formatter | |
| formatString : String
Das Maskenmuster. | ZipCodeFormatter | ||
Geschützte Eigenschaften
Öffentliche Methoden
| Methode | Definiert von | ||
|---|---|---|---|
Konstruktor. | ZipCodeFormatter | ||
[override]
Formatiert den String, indem ein bestimmtes Format verwendet wird. | ZipCodeFormatter | ||
|
Gibt an, ob für ein Objekt eine bestimmte Eigenschaft definiert wurde. | Object | |
|
Gibt an, ob eine Instanz der Object-Klasse in der Prototypkette des Objekts vorhanden ist, das als Parameter angegeben wurde. | Object | |
|
Gibt an, ob die angegebene Eigenschaft vorhanden ist und durchlaufen werden kann. | Object | |
|
Legt die Verfügbarkeit einer dynamischen Eigenschaft für Schleifenoperationen fest. | Object | |
|
Gibt die Stringdarstellung dieses Objekts zurück, formatiert entsprechend den Konventionen des Gebietsschemas. | Object | |
|
Gibt das angegebene Objekt als String zurück. | Object | |
|
Gibt den Grundwert des angegebenen Objekts zurück. | Object | |
Geschützte Methoden
Eigenschaftendetails
formatString | Eigenschaft |
formatString:String| Sprachversion: | ActionScript 3.0 |
| Produktversion: | Flex 3 |
| Laufzeitversionen: | Flash Player 9, AIR 1.1 |
Das Maskenmuster. Mögliche Werte sind "#####-####", "##### ####", "#####", "###-###" und "### ###".
Der Standardwert ist "#####".
Implementierung
public function get formatString():String public function set formatString(value:String):voidKonstruktordetails
ZipCodeFormatter | () | Konstruktor |
public function ZipCodeFormatter()| Sprachversion: | ActionScript 3.0 |
| Produktversion: | Flex 3 |
| Laufzeitversionen: | Flash Player 9, AIR 1.1 |
Konstruktor.
Methodendetails
format | () | Methode |
override public function format(value:Object):String| Sprachversion: | ActionScript 3.0 |
| Produktversion: | Flex 3 |
| Laufzeitversionen: | Flash Player 9, AIR 1.1 |
Formatiert den String, indem ein bestimmtes Format verwendet wird. Wenn der Wert nicht formatiert werden kann, wird ein leerer String zurückgegeben und eine Beschreibung des Fehlers in die Eigenschaft error geschrieben.
Parameter
value:Object — Der zu formatierende Wert.
|
String — Formatierter String. Leer, wenn ein Fehler auftritt. Eine Beschreibung der Fehlerbedingung wird in die Eigenschaft error geschrieben.
|
Beispiele Verwendung dieses Beispiels
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, 10:04 AM Z