| Package | mx.validators |
| Classe | public class CurrencyValidator |
| Héritage | CurrencyValidator  Validator EventDispatcher Object |
| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 3 |
| Versions du moteur d’exécution: | Flash Player 9, AIR 1.1 |
 | A partir de Flex 4.5, Adobe vous recommande d’utiliser la classe spark.validators.CurrencyValidator comme alternative à cette classe. |
La classe CurrencyValidator assure qu’une chaîne représente une expression de monnaie valide. Elle peut s’assurer que l’entrée appartient à une plage donnée (spécifié par
minValue et maxValue), n’est pas négative (spécifié par allowNegative) et ne dépasse pas la valeur precision spécifiée. La classe CurrencyValidator valide correctement les expressions de monnaie formatées et non formatées (par exemple, « $12,345.00 » et « 12345 »). Vous pouvez personnaliser les propriétés currencySymbol, alignSymbol, thousandsSeparator et decimalSeparator à des fins d’internationalisation.
Syntaxe MXML
Afficher la syntaxe MXML
Masquer la syntaxe MXMLThe <mx:CurrencyValidator> tag
inherits all of the tag properties of its superclass,
and adds the following tag properties:
<mx:CurrencyValidator
alignSymbol="left|right|any"
allowNegative="true|false"
currencySymbol="$"
currencySymbolError="The currency symbol occurs in an invalid location."
decimalPointCountError="The decimal separator can occur only once."
decimalSeparator="."
exceedsMaxError="The amount entered is too large."
invalidCharError="The input contains invalid characters."
invalidFormatCharsError="One of the formatting parameters is invalid."
lowerThanMinError="The amount entered is too small."
maxValue="NaN"
minValue="NaN"
negativeError="The amount may not be negative."
precision="2"
precisionError="The amount entered has too many digits beyond the decimal point."
separationError="The thousands separator must be followed by three digits."
thousandsSeparator=","
/>
Eléments de l’API associés
| Propriété | Défini par | ||
|---|---|---|---|
| alignSymbol : String
Spécifie l’alignement de l’objet currencySymbol par rapport au reste de l’expression. | CurrencyValidator | ||
| allowNegative : Object
Indique si les nombres négatifs sont autorisés. | CurrencyValidator | ||
 | constructor : Object
Référence à l’objet de classe ou à la fonction constructeur d’une occurrence donnée d’un objet. | Object | |
| currencySymbol : String
Chaîne de caractères utilisée pour spécifier le symbole de monnaie (par exemple, « $ », « R$ » ou « £ »). | CurrencyValidator | ||
| currencySymbolError : String
Message d’erreur lorsque le symbole de monnaie, défini par la propriété currencySymbol, se situe au mauvais emplacement. | CurrencyValidator | ||
| decimalPointCountError : String
Message d’erreur lorsque le séparateur décimal apparaît plus d’une fois. | CurrencyValidator | ||
| decimalSeparator : String
Caractère utilisé pour séparer le tout de la partie fractionnelle du nombre. | CurrencyValidator | ||
| enabled : Boolean
Si cette valeur est définie sur false, le programme de validation arrête la validation. | Validator | |
| exceedsMaxError : String
Message d’erreur lorsque la valeur est supérieure à la valeur maxValue. | CurrencyValidator | ||
| invalidCharError : String
Message d’erreur lorsque la monnaie contient des caractères non valides. | CurrencyValidator | ||
| invalidFormatCharsError : String
Message d’erreur lorsque la valeur contient un caractère de formatage non valide. | CurrencyValidator | ||
| listener : Object
Spécifie l’écouteur de validation. | Validator | |
| lowerThanMinError : String
Message d’erreur lorsque la valeur est inférieure à la valeur minValue. | CurrencyValidator | ||
| maxValue : Object
Valeur maximale d’un nombre valide. | CurrencyValidator | ||
| minValue : Object
Valeur minimale d’un nombre valide. | CurrencyValidator | ||
| negativeError : String
Message d’erreur lorsque la valeur est négative et que la propriété allowNegative est false. | CurrencyValidator | ||
| precision : Object
Nombre maximal de chiffres pouvant suivre le point décimal. | CurrencyValidator | ||
| precisionError : String
Message d’erreur lorsque la valeur comporte une valeur precision qui dépasse la valeur définie par la propriété precision. | CurrencyValidator | ||
| property : String
Chaîne spécifiant le nom de la propriété de l’objet source qui contient la valeur à valider. | Validator | |
| required : Boolean = true
Si true, indique qu’une valeur manquante ou vide provoque une erreur de validation. | Validator | |
| requiredFieldError : String
Message d’erreur lorsqu’une valeur est manquante et que la propriété requise est true. | Validator | |
| separationError : String
Message d’erreur lorsque le séparateur des milliers est mal placé. | CurrencyValidator | ||
| source : Object
Spécifie l’objet contenant la propriété à valider. | Validator | |
| thousandsSeparator : String
Caractère utilisé pour séparer les milliers. | CurrencyValidator | ||
| trigger : IEventDispatcher
Spécifie le composant qui génère l’événement déclenchant le programme de validation. | Validator | |
| triggerEvent : String
Spécifie l’événement qui déclenche la validation. | Validator | |
| Méthode | Défini par | ||
|---|---|---|---|
Constructeur. | CurrencyValidator | ||
| addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void
Enregistre un objet écouteur d’événement auprès d’un objet EventDispatcher afin que l’écouteur soit averti d’un événement. | EventDispatcher | |
|
Distribue un événement dans le flux d’événements. | EventDispatcher | |
|
Vérifie si des écouteurs sont enregistrés auprès de l’objet EventDispatcher pour un type spécifique d’événement. | EventDispatcher | |
|
Indique si la propriété spécifiée d’un objet est définie. | Object | |
|
Appelé automatiquement par le compilateur MXML lorsque la classe Validator est créée à l’aide d’une balise MXML. | Validator | |
|
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 | |
|
Supprime un écouteur de l’objet EventDispatcher. | EventDispatcher | |
|
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 | |
|
Procède à la validation et, le cas échéant, informe les écouteurs du résultat. | Validator | |
| [statique]
Invoque tous les objets Validator dans le tableau d’objets Validator. | Validator | |
[statique]
Méthode pratique pour appeler une classe Validator. | CurrencyValidator | ||
|
Renvoie la valeur primitive de l’objet spécifié. | Object | |
|
Vérifie si un écouteur d’événement est enregistré auprès de cet objet EventDispatcher ou de ses ancêtres pour le type d’événement spécifié. | EventDispatcher | |
| Méthode | Défini par | ||
|---|---|---|---|
|
Définit tous les écouteurs pour les événements valid et invalid distribués à partir du programme de validation. | Validator | |
[override]
Remplace la méthode doValidation() de la classe de base pour valider une expression de monnaie. | CurrencyValidator | ||
|
Renvoie l’objet à valider. | Validator | |
|
Renvoie une classe ValidationResultEvent depuis le tableau des résultats d’erreurs. | Validator | |
|
Renvoie true si la valeur n’est pas nulle. | Validator | |
|
Déconnecte tous les écouteurs pour les événements valid et invalid distribués à partir du programme de validation. | Validator | |
|
Cette méthode est appelée lorsqu’une classe Validator est construite et chaque fois que la classe ResourceManager distribue un événement « change » pour indiquer que les ressources localisées ont changé d’une manière ou d’une autre. | Validator | |
alignSymbol | propriété |
alignSymbol:String| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 3 |
| Versions du moteur d’exécution: | Flash Player 9, AIR 1.1 |
Spécifie l’alignement de l’objet currencySymbol par rapport au reste de l’expression. Les valeurs acceptables dans ActionScript sont CurrencyValidatorAlignSymbol.LEFT, CurrencyValidatorAlignSymbol.RIGHT et CurrencyValidatorAlignSymbol.ANY. Les valeurs acceptables dans MXML sont "left", "right" et "any".
La valeur par défaut est CurrencyValidatorAlignSymbol.LEFT.
Implémentation
public function get alignSymbol():String public function set alignSymbol(value:String):voidEléments de l’API associés
allowNegative | propriété |
allowNegative:Object| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 3 |
| Versions du moteur d’exécution: | Flash Player 9, AIR 1.1 |
Indique si les nombres négatifs sont autorisés. Peut être true ou false.
La valeur par défaut est true.
Implémentation
public function get allowNegative():Object public function set allowNegative(value:Object):voidcurrencySymbol | propriété |
currencySymbol:String| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 3 |
| Versions du moteur d’exécution: | Flash Player 9, AIR 1.1 |
Chaîne de caractères utilisée pour spécifier le symbole de monnaie (par exemple, « $ », « R$ » ou « £ »). Ne peut pas être un chiffre et doit être distinct des objets thousandsSeparator et decimalSeparator.
La valeur par défaut est "$".
Implémentation
public function get currencySymbol():String public function set currencySymbol(value:String):voidcurrencySymbolError | propriété |
currencySymbolError:String| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 3 |
| Versions du moteur d’exécution: | Flash Player 9, AIR 1.1 |
Message d’erreur lorsque le symbole de monnaie, défini par la propriété currencySymbol, se situe au mauvais emplacement.
La valeur par défaut est "The currency symbol occurs in an invalid location.".
Implémentation
public function get currencySymbolError():String public function set currencySymbolError(value:String):voiddecimalPointCountError | propriété |
decimalPointCountError:String| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 3 |
| Versions du moteur d’exécution: | Flash Player 9, AIR 1.1 |
Message d’erreur lorsque le séparateur décimal apparaît plus d’une fois.
La valeur par défaut est "The decimal separator can only occur once.".
Implémentation
public function get decimalPointCountError():String public function set decimalPointCountError(value:String):voiddecimalSeparator | propriété |
decimalSeparator:String| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 3 |
| Versions du moteur d’exécution: | Flash Player 9, AIR 1.1 |
Caractère utilisé pour séparer le tout de la partie fractionnelle du nombre. Ne peut pas être un chiffre et doit être distinct des objets currencySymbol et thousandsSeparator.
La valeur par défaut est ".".
Implémentation
public function get decimalSeparator():String public function set decimalSeparator(value:String):voidexceedsMaxError | propriété |
exceedsMaxError:String| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 3 |
| Versions du moteur d’exécution: | Flash Player 9, AIR 1.1 |
Message d’erreur lorsque la valeur est supérieure à la valeur maxValue.
La valeur par défaut est "The amount entered is too large.".
Implémentation
public function get exceedsMaxError():String public function set exceedsMaxError(value:String):voidinvalidCharError | propriété |
invalidCharError:String| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 3 |
| Versions du moteur d’exécution: | Flash Player 9, AIR 1.1 |
Message d’erreur lorsque la monnaie contient des caractères non valides.
La valeur par défaut est "The input contains invalid characters.".
Implémentation
public function get invalidCharError():String public function set invalidCharError(value:String):voidinvalidFormatCharsError | propriété |
invalidFormatCharsError:String| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 3 |
| Versions du moteur d’exécution: | Flash Player 9, AIR 1.1 |
Message d’erreur lorsque la valeur contient un caractère de formatage non valide.
La valeur par défaut est "One of the formatting parameters is invalid.".
Implémentation
public function get invalidFormatCharsError():String public function set invalidFormatCharsError(value:String):voidlowerThanMinError | propriété |
lowerThanMinError:String| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 3 |
| Versions du moteur d’exécution: | Flash Player 9, AIR 1.1 |
Message d’erreur lorsque la valeur est inférieure à la valeur minValue.
La valeur par défaut est "The amount entered is too small.".
Implémentation
public function get lowerThanMinError():String public function set lowerThanMinError(value:String):voidmaxValue | propriété |
maxValue:Object| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 3 |
| Versions du moteur d’exécution: | Flash Player 9, AIR 1.1 |
Valeur maximale d’un nombre valide. Une valeur NaN signifie que cette propriété est ignorée.
La valeur par défaut est NaN.
Implémentation
public function get maxValue():Object public function set maxValue(value:Object):voidminValue | propriété |
minValue:Object| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 3 |
| Versions du moteur d’exécution: | Flash Player 9, AIR 1.1 |
Valeur minimale d’un nombre valide. Une valeur NaN signifie que cette propriété est ignorée.
La valeur par défaut est NaN.
Implémentation
public function get minValue():Object public function set minValue(value:Object):voidnegativeError | propriété |
negativeError:String| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 3 |
| Versions du moteur d’exécution: | Flash Player 9, AIR 1.1 |
Message d’erreur lorsque la valeur est négative et que la propriété allowNegative est false.
La valeur par défaut est "The amount may not be negative.".
Implémentation
public function get negativeError():String public function set negativeError(value:String):voidprecision | propriété |
precision:Object| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 3 |
| Versions du moteur d’exécution: | Flash Player 9, AIR 1.1 |
Nombre maximal de chiffres pouvant suivre le point décimal. Peut être n’importe quel nombre entier non négatif. Remarque : définir cette valeur sur 0 a le même effet que définir NumberValidator.domain sur int. Définir cette valeur sur -1 signifie que cette propriété est ignorée.
La valeur par défaut est 2.
Implémentation
public function get precision():Object public function set precision(value:Object):voidprecisionError | propriété |
precisionError:String| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 3 |
| Versions du moteur d’exécution: | Flash Player 9, AIR 1.1 |
Message d’erreur lorsque la valeur comporte une valeur precision qui dépasse la valeur définie par la propriété precision.
La valeur par défaut est "The amount entered has too many digits beyond the decimal point.".
Implémentation
public function get precisionError():String public function set precisionError(value:String):voidseparationError | propriété |
separationError:String| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 3 |
| Versions du moteur d’exécution: | Flash Player 9, AIR 1.1 |
Message d’erreur lorsque le séparateur des milliers est mal placé.
La valeur par défaut est "The thousands separator must be followed by three digits.".
Implémentation
public function get separationError():String public function set separationError(value:String):voidthousandsSeparator | propriété |
thousandsSeparator:String| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 3 |
| Versions du moteur d’exécution: | Flash Player 9, AIR 1.1 |
Caractère utilisé pour séparer les milliers. Ne peut pas être un chiffre et doit être distinct des objets currencySymbol et decimalSeparator.
La valeur par défaut est ",".
Implémentation
public function get thousandsSeparator():String public function set thousandsSeparator(value:String):voidCurrencyValidator | () | Constructeur |
public function CurrencyValidator()| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 3 |
| Versions du moteur d’exécution: | Flash Player 9, AIR 1.1 |
Constructeur.
doValidation | () | méthode |
override protected function doValidation(value:Object):Array| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 3 |
| Versions du moteur d’exécution: | Flash Player 9, AIR 1.1 |
Remplace la méthode doValidation() de la classe de base pour valider une expression de monnaie.
Vous n’appelez pas cette méthode directement ; Flex l’appelle dans le cadre d’une validation. Si vous créez une classe Validator personnalisée, vous devez implémenter cette méthode.
Paramètres
value:Object — Objet à valider.
|
Array — Tableau d’objets ValidationResult, avec un objet ValidationResult pour chaque champ examiné par le programme de validation.
|
validateCurrency | () | méthode |
public static function validateCurrency(validator:CurrencyValidator, value:Object, baseField:String):Array| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 3 |
| Versions du moteur d’exécution: | Flash Player 9, AIR 1.1 |
Méthode pratique pour appeler une classe Validator. Chacune des classes Validator Flex standard comporte une méthode pratique similaire.
Paramètres
validator:CurrencyValidator — Instance CurrencyValidator.
| |
value:Object — Objet à valider.
| |
baseField:String — Représentation textuelle du sous-champ spécifié dans le paramètre value. Par exemple, si le paramètre value spécifie value.currency, la valeur baseField est « currency ».
|
Array — Tableau d’objets ValidationResult, avec un objet ValidationResult pour chaque champ examiné par le programme de validation.
|
Eléments de l’API associés
<?xml version="1.0" encoding="utf-8"?>
<!-- Simple example to demonstrate the CurrencyValidator. -->
<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>
import mx.controls.Alert;
</fx:Script>
<fx:Declarations>
<mx:CurrencyValidator source="{priceUS}" property="text" precision="2"
trigger="{myButton}" triggerEvent="click"
valid="Alert.show('Validation Succeeded!');"/>
</fx:Declarations>
<s:Panel title="CurrencyValidator Example"
width="75%" height="75%"
horizontalCenter="0" verticalCenter="0">
<mx:Form left="10" right="10" top="10" bottom="10">
<mx:FormItem label="Enter a U.S. dollar amount: ">
<s:TextInput id="priceUS" width="100%"/>
</mx:FormItem>
<mx:FormItem >
<s:Button id="myButton" label="Validate"/>
</mx:FormItem>
</mx:Form>
</s:Panel>
</s:Application>
Tue Jun 12 2018, 09:30 AM Z