Package | spark.validators |
Classe | public class CurrencyValidator |
Héritage | CurrencyValidator NumberValidatorBase GlobalizationValidatorBase GlobalizationBase AdvancedStyleClient EventDispatcher Object |
Version du langage: | ActionScript 3.0 |
Version du produit: | Flex 4.5 |
Versions du moteur d’exécution: | Flash Player 10.1, AIR 2.5 |
CurrencyValidator
assure qu’un objet String représente un montant en devise valide conformément aux conventions des paramètres régionaux. Cette classe utilise le style locale
pour spécifier l’ID de paramètres régionaux.
Le valideur peut s’assurer qu’une chaîne de devise figure dans une plage donnée (spécifié par les propriétés minValue
et maxValue
), est un nombre entier (spécifié par la propriété domain
), n’est pas négative (spécifié par la propriété allowNegative
), spécifie correctement les nombres négatifs et positifs, comporte le code ISO ou le symbole de devise correct et ne dépasse pas le nombre spécifié de chiffres après la virgule fractionalDigits
. Le valideur définit les valeurs par défaut des propriétés à l’aide de la classe flash.globalization.CurrencyFormatter
. Par conséquent, les valeurs spécifiques aux paramètres régionaux sont fournies par le système d’exploitation.
La classe flash.globalization.CurrencyFormatter
utilise le système d’exploitation sous-jacent pour fournir les données spécifiques aux paramètres régionaux. Au cas où le système d’exploitation ne fournit pas le formatage des valeurs monétaires, cette classe fournit des fonctionnalités de secours.
The <s:CurrencyValidator>
tag
inherits all of the tag attributes of its superclass,
and adds the following tag attributes:
<s:CurrencyValidator Properties currencyISOCode="locale specified string or customized by user." currencyStringError="Currency name is repeated or not correct." currencySymbol="locale specified string or customized by user." negativeCurrencyFormat="locale specified string or customized by user." negativeCurrencyFormatError="The negative format of the input currency is incorrect." positiveCurrencyFormat="locale specified string or customized by user." positiveCurrencyFormatError="The positive format of the input currency is incorrect." />
Eléments de l’API associés
Propriété | Défini par | ||
---|---|---|---|
actualLocaleIDName : String [lecture seule]
Nom de l’identificateur de paramètres régionaux utilisé par cet objet de classe. | GlobalizationBase | ||
allowNegative : Boolean
Indique si les nombres négatifs sont autorisés. | NumberValidatorBase | ||
className : String [lecture seule]
Nom de la classe du composant. | AdvancedStyleClient | ||
constructor : Object
Référence à l’objet de classe ou à la fonction constructeur d’une occurrence donnée d’un objet. | Object | ||
currencyISOCode : String
Le code de devise ISO 4217 à trois lettres correspondant aux paramètres régionaux en cours d’utilisation. | CurrencyValidator | ||
currencyStringError : String
Message d’erreur lorsque le symbole de devise ou le code ISO de devise est répété ou se trouve à un emplacement incorrect. | CurrencyValidator | ||
currencySymbol : String
Chaîne ou symbole de devise correspondant aux paramètres régionaux actuellement utilisés. | CurrencyValidator | ||
decimalPointCountError : String
Message d’erreur lorsque le séparateur décimal apparaît plus d’une fois. | NumberValidatorBase | ||
decimalSeparator : String
Séparateur décimal utilisé pour la validation des nombres ayant une partie décimale. | NumberValidatorBase | ||
digitsType : uint
Définit le jeu de caractères numériques à utiliser lors de la validation des nombres. | NumberValidatorBase | ||
domain : String
Type de nombre à valider. | NumberValidatorBase | ||
enabled : Boolean
Si cette valeur est définie sur false, le programme de validation arrête la validation. | GlobalizationValidatorBase | ||
fractionalDigits : int
Nombre maximal de chiffres pouvant apparaître après le séparateur décimal. | NumberValidatorBase | ||
fractionalDigitsError : String
Message d’erreur lorsque le nombre de décimales dépasse la valeur spécifiée par la propriété fractionalDigits. | NumberValidatorBase | ||
greaterThanMaxError : String
Message d’erreur lorsque la valeur est supérieure à la propriété maxValue. | NumberValidatorBase | ||
groupingSeparator : String
Caractère ou chaîne utilisé(e) pour le séparateur de groupes. | NumberValidatorBase | ||
id : String
Identité du composant. | AdvancedStyleClient | ||
inheritingStyles : Object
Objet contenant les styles héritables de cette instance de client de style non visuel. | AdvancedStyleClient | ||
invalidCharError : String
Message d’erreur lorsque la valeur contient des caractères non valides. | NumberValidatorBase | ||
invalidFormatCharsError : String
Message d’erreur lorsque la valeur contient des caractères de formatage non valides, ce qui signifie qu’elle contient un chiffre ou un signe moins (-) en tant que caractère de séparateur ou qu’elle contient deux caractères de séparateur consécutifs ou plus. | NumberValidatorBase | ||
lastOperationStatus : String [override] [lecture seule]
Etat de la dernière opération que cet objet de classe a effectuée. | NumberValidatorBase | ||
lessThanMinError : String
Message d’erreur lorsque la valeur est inférieure à la valeur minValue. | NumberValidatorBase | ||
listener : Object
Spécifie l’écouteur de validation. | GlobalizationValidatorBase | ||
localeUndefinedError : String
Message d’erreur lorsque les paramètres régionaux sont non définis ou ne sont pas disponibles. | NumberValidatorBase | ||
maxValue : Number
Valeur maximale d’un nombre valide. | NumberValidatorBase | ||
minValue : Number
Valeur minimale d’un nombre valide. | NumberValidatorBase | ||
moduleFactory : IFlexModuleFactory
Une fabrique de modules est utilisée comme contexte pour la recherche du gestionnaire de style qui contrôle les styles de cette instance de client de style non visuel. | AdvancedStyleClient | ||
negativeCurrencyFormat : uint
Valeur numérique qui indique un modèle de validation des montants en devise négatifs. | CurrencyValidator | ||
negativeCurrencyFormatError : String
Message d’erreur lorsque le format de nombre négatif de la chaîne de devise en entrée est incorrect. | CurrencyValidator | ||
negativeError : String
Message d’erreur lorsque la valeur est négative et que la propriété allowNegative est false. | NumberValidatorBase | ||
negativeSymbol : String [lecture seule]
Le symbole négatif à utiliser lors de la validation de valeurs négatives. | NumberValidatorBase | ||
negativeSymbolError : String
Message d’erreur lorsque le symbole négatif est répété ou est à un emplacement incorrect. | NumberValidatorBase | ||
nonInheritingStyles : Object
Début de la chaîne de styles non hérités de ce composant. | AdvancedStyleClient | ||
notAnIntegerError : String
Message d’erreur lorsque le nombre doit être un nombre entier, tel que défini par la propriété domain. | NumberValidatorBase | ||
parseError : String
Message d’erreur lorsque le nombre n’a pas pu être analysé. | NumberValidatorBase | ||
positiveCurrencyFormat : uint
Valeur numérique qui indique un modèle de validation des montants en devise positifs. | CurrencyValidator | ||
positiveCurrencyFormatError : String
Message d’erreur lorsque le format des valeurs monétaires positives n’est pas correct. | CurrencyValidator | ||
property : String
Chaîne spécifiant le nom de la propriété de l’objet source qui contient la valeur à valider. | GlobalizationValidatorBase | ||
required : Boolean = true
Si true, indique qu’une valeur manquante ou vide provoque une erreur de validation. | GlobalizationValidatorBase | ||
requiredFieldError : String
Message d’erreur lorsqu’une valeur est manquante et que la propriété requise est true. | GlobalizationValidatorBase | ||
source : Object
Spécifie l’objet contenant la propriété à valider. | GlobalizationValidatorBase | ||
styleDeclaration : CSSStyleDeclaration
Déclaration de style contenant les styles en ligne déclarés par cet objet. | AdvancedStyleClient | ||
styleManager : IStyleManager2 [lecture seule]
Renvoie l’instance SystemManager utilisée par ce composant. | AdvancedStyleClient | ||
styleName : Object
Source des valeurs de style de cet objet. | AdvancedStyleClient | ||
styleParent : IAdvancedStyleClient
Le parent d’un composant permet d’évaluer les sélecteurs descendants. | AdvancedStyleClient | ||
trigger : IEventDispatcher
Spécifie le composant qui génère l’événement déclenchant le programme de validation. | GlobalizationValidatorBase | ||
triggerEvent : String
Spécifie l’événement qui déclenche la validation. | GlobalizationValidatorBase |
Méthode | Défini par | ||
---|---|---|---|
Construit un nouvel objet CurrencyValidator pour valider les nombres représentant des montants en devise en fonction des conventions de paramètres régionaux donnés. | 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 | ||
Supprime une propriété de style de cette instance de composant. | AdvancedStyleClient | ||
Distribue un événement dans le flux d’événements. | EventDispatcher | ||
Renvoie un tableau d’objets CSSStyleDeclaration pour le sélecteur de type qui s’applique à ce composant. Renvoie la valeur null si aucun n’existe. | AdvancedStyleClient | ||
[override]
Extrait une propriété de style ayant été définie n’importe où dans la chaîne de recherche de style de ce composant. | GlobalizationBase | ||
Renvoie true si la valeur currentCSSState n’est pas nulle. | AdvancedStyleClient | ||
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 | ||
La méthode initialized est appelée lorsque cette classe ou une classe qui étend cette classe est utilisée dans une déclaration MXML. | AdvancedStyleClient | ||
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 | ||
Renvoie la valeur true si cssState correspond à currentCSSState. | AdvancedStyleClient | ||
Détermine si l’instance est identique au, ou est une sous-classe du, type donné. | AdvancedStyleClient | ||
Propage les changements de style aux enfants de cette instance du client de style. | AdvancedStyleClient | ||
Indique si la propriété spécifiée existe et est énumérable. | Object | ||
Configure les valeurs de cache du style interne afin que la méthode getStyle() fonctionne. | AdvancedStyleClient | ||
Enregistre le gestionnaire EffectManager comme l’un des écouteurs d’événement pour chaque événement d’effet. | AdvancedStyleClient | ||
Supprime un écouteur de l’objet EventDispatcher. | EventDispatcher | ||
Définit la disponibilité d’une propriété dynamique pour les opérations en boucle. | Object | ||
Définit une propriété de style pour cette instance de composant. | AdvancedStyleClient | ||
Détecte les modifications apportées aux propriétés de style. | AdvancedStyleClient | ||
Flex() appelle la méthode stylesInitialized() lorsque les styles d’un composant sont d’abord initialisés. | AdvancedStyleClient | ||
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. | GlobalizationValidatorBase | ||
[statique]
Invoque tous les objets Validator dans le tableau d’objets Validator. | GlobalizationValidatorBase | ||
Méthode pratique pour appeler une classe Validator dans une fonction de validation personnalisée. | 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 |
Les styles sont soit communs soit associés à un thème spécifique. Si le style est commun, il peut être utilisé avec n’importe quel thème. Si un style est associé à un thème spécifique, il ne peut être utilisé que si votre application utilise ce thème.
currencyISOCode | propriété |
currencyISOCode:String
Version du langage: | ActionScript 3.0 |
Version du produit: | Flex 4.5 |
Versions du moteur d’exécution: | Flash Player 10.1, AIR 2.5 |
Le code de devise ISO 4217 à trois lettres correspondant aux paramètres régionaux en cours d’utilisation.
Cette propriété est utilisée pour valider la chaîne ou le symbole de devise présents dans les montants en devise saisis à l’aide de la méthode validate()
.
Cette propriété est initialisée par le constructeur en fonction des paramètres régionaux actuellement spécifiés. En cas d’utilisation de paramètres régionaux par défaut, cette propriété indique le code de devise par défaut correspondant à ces paramètres.
La valeur par défaut dépend des paramètres régionaux et du système d’exploitation
.
Cette propriété peut être utilisée comme source de la liaison de données. Lorsque cette propriété est modifiée, elle distribue l’événement change
.
Implémentation
public function get currencyISOCode():String
public function set currencyISOCode(value:String):void
Eléments de l’API associés
currencyStringError | propriété |
currencyStringError:String
Version du langage: | ActionScript 3.0 |
Version du produit: | Flex 4.5 |
Versions du moteur d’exécution: | Flash Player 10.1, AIR 2.5 |
Message d’erreur lorsque le symbole de devise ou le code ISO de devise est répété ou se trouve à un emplacement incorrect.
La valeur par défaut est "Currency name is repeated or not correct.".
Cette propriété peut être utilisée comme source de la liaison de données. Lorsque cette propriété est modifiée, elle distribue l’événement change
.
Implémentation
public function get currencyStringError():String
public function set currencyStringError(value:String):void
currencySymbol | propriété |
currencySymbol:String
Version du langage: | ActionScript 3.0 |
Version du produit: | Flex 4.5 |
Versions du moteur d’exécution: | Flash Player 10.1, AIR 2.5 |
Chaîne ou symbole de devise correspondant aux paramètres régionaux actuellement utilisés.
Cette propriété est utilisée en tant que symbole de devise lors de la validation des montants en devise à l’aide de la méthode validate()
. Le symbole ou le nom de devise dans la chaîne de validation doit correspondre à la valeur de la propriété currencySymbol
ou de la propriété currencyISOCode
.
Cette propriété est initialisée par le constructeur en fonction des paramètres régionaux actuellement spécifiés. En cas d’utilisation de paramètres régionaux de substitution, cette propriété indique le code de devise par défaut correspondant à ces paramètres.
La valeur par défaut dépend des paramètres régionaux et du système d’exploitation
.
Cette propriété peut être utilisée comme source de la liaison de données. Lorsque cette propriété est modifiée, elle distribue l’événement change
.
Implémentation
public function get currencySymbol():String
public function set currencySymbol(value:String):void
Eléments de l’API associés
negativeCurrencyFormat | propriété |
negativeCurrencyFormat:uint
Version du langage: | ActionScript 3.0 |
Version du produit: | Flex 4.5 |
Versions du moteur d’exécution: | Flash Player 10.1, AIR 2.5 |
Valeur numérique qui indique un modèle de validation des montants en devise négatifs. Cette propriété définit l’emplacement du symbole de devise et du symbole négatif ou des parenthèses par rapport à la partie numérique du montant en devise. Cette propriété permet de valider si la chaîne de devise en entrée suit ou non ce modèle pour les montants négatifs.
La valeur de cette propriété doit être l’une des constantes définies dans le tableau ci-dessous.
- Le symbole ’¤’ représente l’emplacement de la propriété currencyISOCode ou currencySymbol dans la chaîne de devise.
- Le caractère ’-’ représente l’emplacement de la propriété negativeNumberSymbol.
- Le caractère ’n’ représente le montant en devise.
Type de format de devise négatif | Modèle de formatage |
0 | (¤n) |
1 | -¤n |
2 | ¤-n |
3 | ¤n- |
4 | (n¤) |
5 | -n¤ |
6 | n-¤ |
7 | n¤- |
8 | -n ¤ |
9 | -¤ n |
10 | n ¤- |
11 | ¤ n- |
12 | ¤ -n |
13 | n- ¤ |
14 | (¤ n) |
15 | (n ¤) |
La valeur par défaut dépend des paramètres régionaux et du système d’exploitation.
Cette propriété peut être utilisée comme source de la liaison de données. Lorsque cette propriété est modifiée, elle distribue l’événement change
.
Implémentation
public function get negativeCurrencyFormat():uint
public function set negativeCurrencyFormat(value:uint):void
Valeur émise
ArgumentError — si la valeur assignée n’est pas comprise entre 0 et 15.
|
Eléments de l’API associés
negativeCurrencyFormatError | propriété |
negativeCurrencyFormatError:String
Version du langage: | ActionScript 3.0 |
Version du produit: | Flex 4.5 |
Versions du moteur d’exécution: | Flash Player 10.1, AIR 2.5 |
Message d’erreur lorsque le format de nombre négatif de la chaîne de devise en entrée est incorrect.
La valeur par défaut est "The negative format of the input currency is incorrect.".
Cette propriété peut être utilisée comme source de la liaison de données. Lorsque cette propriété est modifiée, elle distribue l’événement change
.
Implémentation
public function get negativeCurrencyFormatError():String
public function set negativeCurrencyFormatError(value:String):void
positiveCurrencyFormat | propriété |
positiveCurrencyFormat:uint
Version du langage: | ActionScript 3.0 |
Version du produit: | Flex 4.5 |
Versions du moteur d’exécution: | Flash Player 10.1, AIR 2.5 |
Valeur numérique qui indique un modèle de validation des montants en devise positifs. Cette propriété définit l’emplacement du symbole de devise par rapport à la partie numérique du montant en devise. Cette propriété permet de valider si la chaîne de devise en entrée suit ce modèle pour les montants positifs.
La valeur de cette propriété doit être l’une des constantes définies dans le tableau ci-dessous.
- Le symbole « ¤ » représente l’emplacement de la propriété
currencyISOCode
oucurrencySymbol
dans la chaîne de devise. - Le caractère « n » représente l’emplacement de la propriété
currencyISOCode
oucurrencySymbol
dans la chaîne de devise.
Type de format de devise positif | Modèle de formatage |
0 | ¤n |
1 | n¤ |
2 | ¤ n |
3 | n ¤ |
La valeur par défaut dépend des paramètres régionaux et du système d’exploitation.
Cette propriété peut être utilisée comme source de la liaison de données. Lorsque cette propriété est modifiée, elle distribue l’événement change
.
Implémentation
public function get positiveCurrencyFormat():uint
public function set positiveCurrencyFormat(value:uint):void
Valeur émise
ArgumentError — si la valeur assignée n’est pas comprise entre 0 et 3.
|
Eléments de l’API associés
positiveCurrencyFormatError | propriété |
positiveCurrencyFormatError:String
Version du langage: | ActionScript 3.0 |
Version du produit: | Flex 4.5 |
Versions du moteur d’exécution: | Flash Player 10.1, AIR 2.5 |
Message d’erreur lorsque le format des valeurs monétaires positives n’est pas correct.
La valeur par défaut est "The positive format of the input currency is incorrect.".
Cette propriété peut être utilisée comme source de la liaison de données. Lorsque cette propriété est modifiée, elle distribue l’événement change
.
Implémentation
public function get positiveCurrencyFormatError():String
public function set positiveCurrencyFormatError(value:String):void
CurrencyValidator | () | Constructeur |
public function CurrencyValidator()
Version du langage: | ActionScript 3.0 |
Version du produit: | Flex 4.5 |
Versions du moteur d’exécution: | Flash Player 10.1, AIR 2.5 |
Construit un nouvel objet CurrencyValidator
pour valider les nombres représentant des montants en devise en fonction des conventions de paramètres régionaux donnés.
Les paramètres régionaux pour cette classe sont fournis par la propriété de style locale
. Le style locale
peut être défini de plusieurs manières :
-
En héritant le style à partir d’un composant
UIComponent
en appelant la méthodeaddStyleClient
du composantUIComponent
. - En utilisant la classe dans une déclaration MXML et en héritant les paramètres régionaux à partir du document qui contient la déclaration.
<fx:Declarations> <s:CurrencyValidator id="cv" /> </fx:Declarations>
<fx:Declarations> <s:CurrencyValidator id="cv_turkish" locale="tr-TR" /> </fx:Declarations>
cv.setStyle("locale", "tr-TR")
.
Si le style locale
n’est défini par aucune des techniques ci-dessus, l’instance de cette classe sera ajoutée comme StyleClient
à topLevelApplication
. Elle hérite par conséquent du style locale
de l’objet topLevelApplication
lors de l’appel de l’accesseur de lecture de la propriété dépendante de locale
ou de la méthode dépendante de locale
.
Les propriétés associées au format de chaîne de devise sont définies sur les valeurs par défaut en fonction des paramètres régionaux.
REMARQUE : en cas d’utilisation de paramètres régionaux de secours, les propriétés de devise sont définies sur les valeurs par défaut des paramètres régionaux en_US. Par conséquent, elles peuvent ne pas correspondre à la devise à laquelle la validation est destinée. Il est judicieux d’examiner les valeurs des propriétés currencySymbol
et currencyISOCode
avant de valider un montant en devise.
Eléments de l’API associés
validateCurrency | () | méthode |
public function validateCurrency(value:Object, baseField:String):Array
Version du langage: | ActionScript 3.0 |
Version du produit: | Flex 4.5 |
Versions du moteur d’exécution: | Flash Player 10.1, AIR 2.5 |
Méthode pratique pour appeler une classe Validator dans une fonction de validation personnalisée. Chacun des programmes de validation Flex standard comporte une méthode de commodité similaire. L’appelant doit vérifier l’état de validation des objets ValidationResult
du tableau renvoyé.
Paramètres
value:Object — Chaîne numérique de devise à valider. La chaîne numérique peut utiliser les symboles moins Unicode 0x2212, 0XFE63, 0XFF0D et ascii.
| |
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.number, la valeur baseField est « number ».
|
Array — Composant Array 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"?> <!-- Sample program for spark.formatters.NumberValidator --> <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:Declarations> <s:CurrencyValidator id="currencyValidator" source='{inputNumber}' property="text" trigger='{validateBtn}' triggerEvent="click" /> <s:CurrencyFormatter id="currencyFormatter" useCurrencySymbol="true" useGrouping="true"/> </fx:Declarations> <fx:Script> <![CDATA[ [Bindable] private var number:Number = 123456789.12; ]]> </fx:Script> <mx:Form> <mx:FormItem label="Input Locale ID Name"> <mx:HBox> <s:TextInput id="inputLocaleIDName" text="en-US"/> <!-- Upon button click, sets the locale style on the document UI component. The formatter will inherit this style. --> <s:Button click="setStyle('locale', inputLocaleIDName.text);" label="Apply"/> </mx:HBox> <mx:Text text="Example: 'en-US', 'fr-FR', 'ja-JP', 'ar-SA'"/> </mx:FormItem> <mx:FormItem label="Allow Negative"> <mx:CheckBox id="alowNegative" selected="true" change="currencyValidator.allowNegative = alowNegative.selected"/> </mx:FormItem> <mx:FormItem label="Fractional Digits"> <mx:TextInput id="fractionalDigits" text='{currencyValidator.fractionalDigits}' change="currencyFormatter.fractionalDigits = currencyValidator.fractionalDigits = Number(fractionalDigits.text)"/> </mx:FormItem> <mx:FormItem label="Currency Symbol"> <mx:TextInput id="currencySymbol" text='{currencyValidator.currencySymbol}' change="currencyFormatter.currencySymbol = currencyValidator.currencySymbol = currencySymbol.text"/> </mx:FormItem> <mx:FormItem label="Actual Locale ID Name"> <mx:Text text="{currencyValidator.actualLocaleIDName}"/> </mx:FormItem> <mx:FormItem label="Enter currency amount" > <mx:HBox> <mx:TextInput id="inputNumber" /> <mx:Button id="validateBtn" label="Validate" /> </mx:HBox> </mx:FormItem> <mx:FormItem label="Example currency"> <mx:Text text="{currencyFormatter.format(123456789.12)}"/> </mx:FormItem> </mx:Form> </s:Application>
Tue Jun 12 2018, 09:30 AM Z