PhoneFormatter

Paket	mx.formatters
Klasse	public class PhoneFormatter
Vererbung	PhoneFormatter Formatter Object

Sprachversion:

ActionScript 3.0

Produktversion:

Flex 3

Laufzeitversionen:

Flash Player 9, AIR 1.1

Die PhoneFormatter-Klasse formatiert eine gültige Zahl in ein Telefonnummernformat, einschließlich internationale Konfigurationen.

Eine Verknüpfung wird für das siebenstellige Format der USA zur Verfügung gestellt. Wenn die Eigenschaft areaCode einen Wert enthält und Sie den siebenstelligen Formatstring (###-####) verwenden, wird durch einen siebenstelligen Wert für die automatische Formatierung die Vorwahl zu dem zurückgegebenen String hinzugefügt. Das Standardformat für die Vorwahl lautet (###). Dieses Format können Sie mithilfe der Eigenschaft areaCodeFormat ändern. Sie können die Vorwahl beliebig formatieren, sofern sie drei Zahlenplatzhalter enthält.

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. Andernfalls enthält der Wert eine unterschiedliche Anzahl von Stellen als im Formatstring angegeben.
"Invalid format" bedeutet, dass die Zeichen in der Eigenschaft formatString nicht den zulässigen Zeichen in der Eigenschaft validPatternChars entsprechen oder die Eigenschaft areaCodeFormat zwar angegeben ist, aber nicht genau drei numerische Platzhalter enthält.

MXML-Syntax expanded

MXML-Syntax ausblenden

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

  <mx:PhoneFormatter
    areaCode="-1"
    areaCodeFormat="(###)"
    formatString="(###) ###-####"
    validPatternChars="+()#-. "
  />

Beispiele anzeigen

Verwandte API-Elemente

mx.formatters.SwitchSymbolFormatter

Öffentliche Eigenschaften

Vererbte öffentliche Eigenschaften ausblenden

Vererbte öffentliche Eigenschaften anzeigen

	Eigenschaft		Definiert von
		areaCode : Object Vorwahlzahlen, die zu einer siebenstelligen Telefonnummer der USA hinzugefügt werden und so eine zehnstellige Telefonnummer bilden.	PhoneFormatter
		areaCodeFormat : String Standardformat für die Vorwahl, wenn die Eigenschaft „areacode“ von einem siebenstelligen Format gerendert wird.	PhoneFormatter
		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 String, der Maskenzeichen enthält, die ein bestimmtes Telefonummernformat darstellen.	PhoneFormatter
		validPatternChars : String Liste der gültigen Zeichen, die in der Eigenschaft formatString verwendet werden können.	PhoneFormatter

Geschützte Eigenschaften

Vererbte geschützte Eigenschaften ausblenden

Vererbte geschützte Eigenschaften anzeigen

	Eigenschaft		Definiert von
		resourceManager : IResourceManager [schreibgeschützt] Ein Verweis auf ein Objekt, welches alle lokalisierten Ressourcen der Anwendung verwaltet.	Formatter

Öffentliche Methoden

Vererbte öffentliche Methoden ausblenden

Vererbte öffentliche Methoden anzeigen

	Methode		Definiert von
		PhoneFormatter() Konstruktor.	PhoneFormatter
		format(value:Object):String [override] Formatiert den String als eine Telefonnummer.	PhoneFormatter
		hasOwnProperty(name:String):Boolean Gibt an, ob für ein Objekt eine bestimmte Eigenschaft definiert wurde.	Object
		isPrototypeOf(theClass:Object):Boolean Gibt an, ob eine Instanz der Object-Klasse in der Prototypkette des Objekts vorhanden ist, das als Parameter angegeben wurde.	Object
		propertyIsEnumerable(name:String):Boolean Gibt an, ob die angegebene Eigenschaft vorhanden ist und durchlaufen werden kann.	Object
		setPropertyIsEnumerable(name:String, isEnum:Boolean = true):void Legt die Verfügbarkeit einer dynamischen Eigenschaft für Schleifenoperationen fest.	Object
		toLocaleString():String Gibt die Stringdarstellung dieses Objekts zurück, formatiert entsprechend den Konventionen des Gebietsschemas.	Object
		toString():String Gibt das angegebene Objekt als String zurück.	Object
		valueOf():Object Gibt den Grundwert des angegebenen Objekts zurück.	Object

Geschützte Methoden

Vererbte geschützte Methoden ausblenden

Vererbte geschützte Methoden anzeigen

	Methode		Definiert von
		resourcesChanged():void 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

areaCode

Eigenschaft

areaCode:Object

Sprachversion:

ActionScript 3.0

Produktversion:

Flex 3

Laufzeitversionen:

Flash Player 9, AIR 1.1

Vorwahlzahlen, die zu einer siebenstelligen Telefonnummer der USA hinzugefügt werden und so eine zehnstellige Telefonnummer bilden. Ein Wert von -1 bedeutet, dass die Vorwahl nicht vorangestellt wird.

Der Standardwert ist -1.

Implementierung
public function get areaCode():Object
public function set areaCode(value:Object):void

areaCodeFormat

Eigenschaft

areaCodeFormat:String

Sprachversion:

ActionScript 3.0

Produktversion:

Flex 3

Laufzeitversionen:

Flash Player 9, AIR 1.1

Standardformat für die Vorwahl, wenn die Eigenschaft areacode von einem siebenstelligen Format gerendert wird.

Der Standardwert ist "(###) ".

Implementierung
public function get areaCodeFormat():String
public function set areaCodeFormat(value:String):void

formatString

Eigenschaft

formatString:String

Sprachversion:

ActionScript 3.0

Produktversion:

Flex 3

Laufzeitversionen:

Flash Player 9, AIR 1.1

String, der Maskenzeichen enthält, die ein bestimmtes Telefonummernformat darstellen.

Der Standardwert ist "(###) ###-####".

Implementierung
public function get formatString():String
public function set formatString(value:String):void

validPatternChars

Eigenschaft

validPatternChars:String

Sprachversion:

ActionScript 3.0

Produktversion:

Flex 3

Laufzeitversionen:

Flash Player 9, AIR 1.1

Liste der gültigen Zeichen, die in der Eigenschaft formatString verwendet werden können. Diese Eigenschaft wird während der Validierung der Eigenschaft formatString verwendet.

Der Standardwert ist "+()#- .".

Implementierung
public function get validPatternChars():String
public function set validPatternChars(value:String):void

Konstruktordetails

()

Konstruktor

public function PhoneFormatter()

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 als eine Telefonnummer. 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.

Beispiele Verwendung dieses Beispiels

PhoneFormatterExample.mxml

<?xml version="1.0" encoding="utf-8"?>
<!-- Simple example to demonstrate PhoneFormatter. -->
<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 = pnVal.validate();
                if (vResult.type == ValidationResultEvent.VALID) {
                    formattedPhone.text = phoneFormatter.format(phone.text);
                } else {
                    formattedPhone.text = "";
                }
            }
        ]]>
    </fx:Script>

    <fx:Declarations>
        <mx:PhoneFormatter id="phoneFormatter" 
                formatString="(###) ###-####" validPatternChars="#-() "/>

        <mx:PhoneNumberValidator id="pnVal" source="{phone}" property="text" 
                allowedFormatChars=""/>
    </fx:Declarations>

    <s:Panel title="PhoneFormatter Example"
            width="75%" height="75%"
            horizontalCenter="0" verticalCenter="0">
        <mx:Form left="10" right="10" top="10" bottom="10">
            <mx:FormItem label="Enter a 10-digit phone number:">
                <s:TextInput id="phone" text="" width="75%"/>
            </mx:FormItem>
            <mx:FormItem label="Formatted phone number: ">
                <s:TextInput id="formattedPhone" text="" width="75%" editable="false"/>
            </mx:FormItem>
            <mx:FormItem>
                <s:Button label="Validate and Format" click="Format();"/>
            </mx:FormItem>
        </mx:Form>
    </s:Panel>

</s:Application>

Rechtliche Hinweise | Onlinedatenschutzerklärung

PhoneFormatter - AS3 Flex

Klassen x

areaCode

areaCodeFormat

formatString

validPatternChars

PhoneFormatter

format