ActionScript® 3.0 Referenzhandbuch für die Adobe® Flash®-Plattform
Home  |  Liste der Pakete und Klassen ausblenden |  Pakete  |  Klassen  |  Neue Funktionen  |  Stichwortverzeichnis  |  Anhänge  |  Warum auf Englisch?
Filter: Daten werden vom Server abgerufen...
Daten werden vom Server abgerufen...
mx.formatters 

ZipCodeFormatter  - AS3 Flex

Paketmx.formatters
Klassepublic class ZipCodeFormatter
VererbungZipCodeFormatter Inheritance Formatter Inheritance Object

Sprachversion: ActionScript 3.0
Produktversion: Flex 3
Laufzeitversionen: Flash Player 9, AIR 1.1

Die ZipCodeFormatter-Klasse formatiert basierend auf der vom Benutzer zur Verfügung gestellten 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 die format()-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 Eigenschaft formatString überein.
  • "Invalid format" bedeutet, dass die Zeichen der Eigenschaft formatString nicht mit den zulässigen Zeichen der Eigenschaft validFormatChars übereinstimmen oder die Anzahl der numerischen Platzhalter nicht 9, 5 oder 6 entspricht.

MXML-SyntaxexpandedMXML-Syntax ausblenden

The <mx:ZipCodeFormatter> tag inherits all of the tag attributes of its superclass, and adds the following tag attributes:

  <mx:ZipCodeFormatter
    formatString="#####|#####-####|### ###"
  />
  

Beispiele anzeigen

Verwandte API-Elemente



Öffentliche Eigenschaften
 EigenschaftDefiniert von
 Inheritedconstructor : Object
Ein Verweis auf das Klassenobjekt oder die Konstruktorfunktion für eine angegebene Objektinstanz.
Object
 Inheritederror : String
Beschreibung, die von der Formatierung gespeichert wird, wenn ein Fehler auftritt.
Formatter
  formatString : String
Das Maskenmuster.
ZipCodeFormatter
Geschützte Eigenschaften
 EigenschaftDefiniert von
 InheritedresourceManager : IResourceManager
[schreibgeschützt] Ein Verweis auf ein Objekt, welches alle lokalisierten Ressourcen der Anwendung verwaltet.
Formatter
Öffentliche Methoden
 MethodeDefiniert von
  
Konstruktor.
ZipCodeFormatter
  
[override] Formatiert den String, indem ein bestimmtes Format verwendet wird.
ZipCodeFormatter
 Inherited
Gibt an, ob für ein Objekt eine bestimmte Eigenschaft definiert wurde.
Object
 Inherited
Gibt an, ob eine Instanz der Object-Klasse in der Prototypkette des Objekts vorhanden ist, das als Parameter angegeben wurde.
Object
 Inherited
Gibt an, ob die angegebene Eigenschaft vorhanden ist und durchlaufen werden kann.
Object
 Inherited
Legt die Verfügbarkeit einer dynamischen Eigenschaft für Schleifenoperationen fest.
Object
 Inherited
Gibt die Stringdarstellung dieses Objekts zurück, formatiert entsprechend den Konventionen des Gebietsschemas.
Object
 Inherited
Gibt das angegebene Objekt als String zurück.
Object
 Inherited
Gibt den Grundwert des angegebenen Objekts zurück.
Object
Geschützte Methoden
 MethodeDefiniert von
 Inherited
Diese Methode wird aufgerufen, wenn eine Formatierung erstellt wird, und wird erneut aufgerufen, wenn ResourceManager ein „change“-Ereignis auslöst, um anzugeben, dass sich die lokalisierten Ressourcen geändert haben.
Formatter
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):void
Konstruktordetails

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.

Rückgabewerte
String — Formatierter String. Leer, wenn ein Fehler auftritt. Eine Beschreibung der Fehlerbedingung wird in die Eigenschaft error geschrieben.
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>




[ X ]Warum auf Englisch?
Inhalt des ActionScript 3.0-Referenzhandbuchs wird in englischer Sprache angezeigt

Nicht alle Teile des ActionScript 3.0-Referenzhandbuchs wurden in alle Sprachen übersetzt. Wenn der Text zu einem Sprachelement nicht übersetzt wurde, wird er auf Englisch angezeigt. Zum Beispiel wurden die Informationen zur ga.controls.HelpBox-Klasse nicht in andere Sprachen übersetzt. In der deutschen Version des Referenzhandbuchs erscheint der Abschnitt zur ga.controls.HelpBox-Klasse deshalb auf Englisch.