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 |
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 dieformat()
-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 EigenschaftformatString
nicht den zulässigen Zeichen in der EigenschaftvalidPatternChars
entsprechen oder die EigenschaftareaCodeFormat
zwar angegeben ist, aber nicht genau drei numerische Platzhalter enthält.
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="+()#-. " />
Verwandte API-Elemente
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 |
Methode | Definiert von | ||
---|---|---|---|
Konstruktor. | PhoneFormatter | ||
[override]
Formatiert den String als eine Telefonnummer. | PhoneFormatter | ||
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 |
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
PhoneFormatter | () | Konstruktor |
public function PhoneFormatter()
Sprachversion: | ActionScript 3.0 |
Produktversion: | Flex 3 |
Laufzeitversionen: | Flash Player 9, AIR 1.1 |
Konstruktor.
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.
|
String — Formatierter String. Leer, wenn ein Fehler auftritt. Eine Beschreibung der Fehlerbedingung wird in die Eigenschaft error geschrieben.
|
<?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>
Tue Jun 12 2018, 10:04 AM Z