Package | mx.formatters |
Classe | public class ZipCodeFormatter |
Héritage | ZipCodeFormatter Formatter Object |
Version du langage: | ActionScript 3.0 |
Version du produit: | Flex 3 |
Versions du moteur d’exécution: | Flash Player 9, AIR 1.1 |
formatString
définie par l’utilisateur.
- #####-####
- ##### ####
- #####
- ### ### (Canada)
Un nombre à six chiffres doit être fourni pour un modèle à six chiffres. Si vous utilisez un modèle composé de cinq ou neuf chiffres, vous pouvez utiliser un nombre à cinq ou neuf chiffres pour le formatage.
Si une erreur se produit, une chaîne vide est renvoyée et une chaîne décrivant l’erreur est enregistrée dans la propriété error
. La propriété error
peut prendre l’une des valeurs suivantes :
-
"Invalid value"
signifie qu’une valeur numérique non valide a été transmise à la méthodeformat()
. La valeur doit être un nombre valide sous forme de nombre ou de chaîne (sauf pour les codes postaux canadiens, qui autorisent les valeurs alphanumériques), ou le nombre de chiffres ne correspond pas au nombre de chiffres autorisés par la propriétéformatString
. -
"Invalid format"
signifie qu’au moins un des caractères de la propriétéformatString
ne correspond pas aux caractères autorisés spécifiés dans la propriétévalidFormatChars
ou que le nombre d’espaces réservés numériques est différent de neuf, cinq ou six.
The <mx:ZipCodeFormatter>
tag
inherits all of the tag attributes of its superclass,
and adds the following tag attributes:
<mx:ZipCodeFormatter formatString="#####|#####-####|### ###" />
Eléments de l’API associés
Propriété | Défini par | ||
---|---|---|---|
constructor : Object
Référence à l’objet de classe ou à la fonction constructeur d’une occurrence donnée d’un objet. | Object | ||
error : String
Description enregistrée par la classe de formatage lorsqu’une erreur survient. | Formatter | ||
formatString : String
Modèle de masque. | ZipCodeFormatter |
Méthode | Défini par | ||
---|---|---|---|
Constructeur. | ZipCodeFormatter | ||
[override]
Formate la chaîne en utilisant le format spécifié. | ZipCodeFormatter | ||
Indique si la propriété spécifiée d’un objet est définie. | Object | ||
Indique si une occurrence de la classe Object figure dans la chaîne de prototype de l’objet spécifié en tant que paramètre. | Object | ||
Indique si la propriété spécifiée existe et est énumérable. | Object | ||
Définit la disponibilité d’une propriété dynamique pour les opérations en boucle. | Object | ||
Renvoie la représentation de chaîne de cet objet, formatée selon les paramètres régionaux en vigueur. | Object | ||
Renvoie la représentation sous forme de chaîne de l’objet spécifié. | Object | ||
Renvoie la valeur primitive de l’objet spécifié. | Object |
formatString | propriété |
formatString:String
Version du langage: | ActionScript 3.0 |
Version du produit: | Flex 3 |
Versions du moteur d’exécution: | Flash Player 9, AIR 1.1 |
Modèle de masque. Valeurs possibles : "#####-####"
, "##### ####"
, "#####"
, "###-###"
et "### ###"
.
La valeur par défaut est "#####".
Implémentation
public function get formatString():String
public function set formatString(value:String):void
ZipCodeFormatter | () | Constructeur |
public function ZipCodeFormatter()
Version du langage: | ActionScript 3.0 |
Version du produit: | Flex 3 |
Versions du moteur d’exécution: | Flash Player 9, AIR 1.1 |
Constructeur.
format | () | méthode |
override public function format(value:Object):String
Version du langage: | ActionScript 3.0 |
Version du produit: | Flex 3 |
Versions du moteur d’exécution: | Flash Player 9, AIR 1.1 |
Formate la chaîne en utilisant le format spécifié. S’il est impossible de formater la valeur, une chaîne vide est renvoyée et une description de l’erreur est écrite dans la propriété error
.
Paramètres
value:Object — Valeur à formater.
|
String — Chaîne formatée. Vide si une erreur se produit. Une description de la condition d’erreur est écrite dans la propriété error .
|
<?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, 09:30 AM Z