| 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 EigenschaftformatStringnicht den zulässigen Zeichen in der EigenschaftvalidPatternCharsentsprechen oder die EigenschaftareaCodeFormatzwar angegeben ist, aber nicht genau drei numerische Platzhalter enthält.
MXML-Syntax anzeigen
MXML-Syntax ausblendenThe <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):voidareaCodeFormat | 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):voidformatString | 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):voidvalidPatternChars | 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):voidPhoneFormatter | () | 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