NumberValidator

Package	mx.validators
Classe	public class NumberValidator
Héritage	NumberValidator 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.NumberValidator comme alternative à cette classe.

La classe NumberValidator assure qu’une chaîne représente un nombre valide. Elle peut s’assurer que l’entrée appartient à une plage donnée (spécifié par minValue et maxValue), est un nombre entier (spécifié par domain), n’est pas négative (spécifié par allowNegative) et ne dépasse pas la valeur precision spécifiée. Le programme de validation valide correctement les nombres formatés (par exemple, « 12,345.67 ») et vous pouvez personnaliser les propriétés thousandsSeparator et decimalSeparator à des fin d’internationalisation.

Syntaxe MXML expanded

Masquer la syntaxe MXML

The <mx:NumberValidator> tag inherits all of the tag attributes of its superclass, and adds the following tag attributes:

  <mx:NumberValidator 
    allowNegative="true|false" 
    decimalPointCountError="The decimal separator can only occur once." 
    decimalSeparator="." 
    domain="real|int" 
    exceedsMaxError="The number entered is too large." 
    integerError="The number must be an integer." 
    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="-1" 
    precisionError="The amount entered has too many digits beyond the decimal point." 
    separationError="The thousands separator must be followed by three digits." 
    thousandsSeparator="," 
  />

Consulter les exemples

Propriétés publiques

Masquer les propriétés publiques héritées

Afficher les propriétés publiques héritées

	Propriété		Défini par
		allowNegative : Object Indique si les nombres négatifs sont autorisés.	NumberValidator
		constructor : Object Référence à l’objet de classe ou à la fonction constructeur d’une occurrence donnée d’un objet.	Object
		decimalPointCountError : String Message d’erreur lorsque le séparateur décimal apparaît plus d’une fois.	NumberValidator
		decimalSeparator : String Caractère utilisé pour séparer le tout de la partie fractionnelle du nombre.	NumberValidator
		domain : String Type de nombre à valider.	NumberValidator
		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 propriété maxValue.	NumberValidator
		integerError : String Message d’erreur lorsque le nombre doit être un nombre entier, tel que défini par la propriété domain.	NumberValidator
		invalidCharError : String Message d’erreur lorsque la valeur contient des caractères non valides.	NumberValidator
		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.	NumberValidator
		listener : Object Spécifie l’écouteur de validation.	Validator
		lowerThanMinError : String Message d’erreur lorsque la valeur est inférieure à la valeur minValue.	NumberValidator
		maxValue : Object Valeur maximale d’un nombre valide.	NumberValidator
		minValue : Object Valeur minimale d’un nombre valide.	NumberValidator
		negativeError : String Message d’erreur lorsque la valeur est négative et que la propriété allowNegative est false.	NumberValidator
		precision : Object Nombre maximal de chiffres pouvant suivre le point décimal.	NumberValidator
		precisionError : String Message d’erreur lorsque la valeur comporte une valeur precision qui dépasse la valeur définie par la propriété precision.	NumberValidator
		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 se situe au mauvais emplacement.	NumberValidator
		source : Object Spécifie l’objet contenant la propriété à valider.	Validator
		thousandsSeparator : String Caractère utilisé pour séparer les milliers dans l’intégralité du nombre.	NumberValidator
		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

Propriétés protégées

Masquer les propriétés protégées héritées

Afficher les propriétés protégées héritées

	Propriété		Défini par
		actualListeners : Array [lecture seule] Contient un tableau d’objets d’écouteurs, le cas échéant, ou l’objet source.	Validator
		actualTrigger : IEventDispatcher [lecture seule] Contient l’objet déclencheur, le cas échéant, ou l’objet source.	Validator
		resourceManager : IResourceManager [lecture seule] Référence à l’objet qui gère toutes les ressources localisées de l’application.	Validator
		subFields : Array Tableau de chaînes contenant les noms des propriétés contenues dans l’objet value transmis à la méthode validate().	Validator

Méthodes publiques

Masquer les méthodes publiques héritées

Afficher les méthodes publiques héritées

	Méthode		Défini par
		NumberValidator() Constructeur.	NumberValidator
		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
		dispatchEvent(event:Event):Boolean Distribue un événement dans le flux d’événements.	EventDispatcher
		hasEventListener(type:String):Boolean Vérifie si des écouteurs sont enregistrés auprès de l’objet EventDispatcher pour un type spécifique d’événement.	EventDispatcher
		hasOwnProperty(name:String):Boolean Indique si la propriété spécifiée d’un objet est définie.	Object
		initialized(document:Object, id:String):void Appelé automatiquement par le compilateur MXML lorsque la classe Validator est créée à l’aide d’une balise MXML.	Validator
		isPrototypeOf(theClass:Object):Boolean 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
		propertyIsEnumerable(name:String):Boolean Indique si la propriété spécifiée existe et est énumérable.	Object
		removeEventListener(type:String, listener:Function, useCapture:Boolean = false):void Supprime un écouteur de l’objet EventDispatcher.	EventDispatcher
		setPropertyIsEnumerable(name:String, isEnum:Boolean = true):void Définit la disponibilité d’une propriété dynamique pour les opérations en boucle.	Object
		toLocaleString():String Renvoie la représentation de chaîne de cet objet, formatée selon les paramètres régionaux en vigueur.	Object
		toString():String Renvoie la représentation sous forme de chaîne de l’objet spécifié.	Object
		validate(value:Object = null, suppressEvents:Boolean = false):ValidationResultEvent Procède à la validation et, le cas échéant, informe les écouteurs du résultat.	Validator
		validateAll(validators:Array):Array [statique] Invoque tous les objets Validator dans le tableau d’objets Validator.	Validator
		validateNumber(validator:NumberValidator, value:Object, baseField:String):Array [statique] Méthode pratique pour appeler une classe Validator dans une fonction de validation personnalisée.	NumberValidator
		valueOf():Object Renvoie la valeur primitive de l’objet spécifié.	Object
		willTrigger(type:String):Boolean 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éthodes protégées

Masquer les méthodes protégées héritées

Afficher les méthodes protégées héritées

	Méthode		Défini par
		addListenerHandler():void Définit tous les écouteurs pour les événements valid et invalid distribués à partir du programme de validation.	Validator
		doValidation(value:Object):Array [override] Remplace la méthode doValidation() de la classe de base pour valider un nombre.	NumberValidator
		getValueFromSource():Object Renvoie l’objet à valider.	Validator
		handleResults(errorResults:Array):ValidationResultEvent Renvoie une classe ValidationResultEvent depuis le tableau des résultats d’erreurs.	Validator
		isRealValue(value:Object):Boolean Renvoie true si la valeur n’est pas nulle.	Validator
		removeListenerHandler():void Déconnecte tous les écouteurs pour les événements valid et invalid distribués à partir du programme de validation.	Validator
		resourcesChanged():void 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

Evénements

Cliquez pour plus d’informations sur les événements

Masquer les événements hérités

Afficher les événements hérités

	Synthèse	Défini par
activate	[Evénement de diffusion] Distribué lorsque l’application Flash Player obtient le focus du système d’exploitation et devient active.	EventDispatcher
deactivate	[Evénement de diffusion] Distribué lorsque l’application Flash Player ou AIR perd le focus du système d’exploitation et devient inactive.	EventDispatcher
invalid	Distribué si la validation échoue.	Validator
valid	Distribué si la validation réussit.	Validator

Constantes protégées

Masquer les constantes protégées héritées

Afficher les constantes protégées héritées

	Constante		Défini par

Détails de la propriété

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. Les valeurs possibles sont true ou false.

La valeur par défaut est true.

Implémentation
public function get allowNegative():Object
public function set allowNegative(value:Object):void

decimalPointCountError

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 occur only once.".

Implémentation
public function get decimalPointCountError():String
public function set decimalPointCountError(value:String):void

decimalSeparator

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 de l’objet thousandsSeparator.

La valeur par défaut est ".".

Implémentation
public function get decimalSeparator():String
public function set decimalSeparator(value:String):void

domain

propriété

domain:String

Version du langage:

ActionScript 3.0

Version du produit:

Flex 3

Versions du moteur d’exécution:

Flash Player 9, AIR 1.1

Type de nombre à valider. Les valeurs autorisées sont "real" et "int".

Dans le langage ActionScript, vous pouvez utiliser les constantes suivantes pour définir cette propriété : NumberValidatorDomainType.REAL ou NumberValidatorDomainType.INT.

La valeur par défaut est "real".

Implémentation
public function get domain():String
public function set domain(value:String):void

exceedsMaxError

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 propriété maxValue.

La valeur par défaut est "The number entered is too large.".

Implémentation
public function get exceedsMaxError():String
public function set exceedsMaxError(value:String):void

integerError

propriété

integerError: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 nombre doit être un nombre entier, tel que défini par la propriété domain.

La valeur par défaut est "The number must be an integer.".

Implémentation
public function get integerError():String
public function set integerError(value:String):void

invalidCharError

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 valeur 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):void

invalidFormatCharsError

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 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.

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):void

lowerThanMinError

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):void

maxValue

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 qu’il n’existe pas de maximum.

La valeur par défaut est NaN.

Implémentation
public function get maxValue():Object
public function set maxValue(value:Object):void

minValue

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 qu’il n’existe pas de minimum.

La valeur par défaut est NaN.

Implémentation
public function get minValue():Object
public function set minValue(value:Object):void

negativeError

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):void

precision

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 domain sur "int". Une valeur de -1 signifie que cette propriété est ignorée.

La valeur par défaut est -1.

Implémentation
public function get precision():Object
public function set precision(value:Object):void

precisionError

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):void

separationError

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 se situe au mauvais emplacement.

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):void

thousandsSeparator

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 dans l’intégralité du nombre. Ne peut pas être un chiffre et doit être distinct de l’objet decimalSeparator.

La valeur par défaut est ",".

Implémentation
public function get thousandsSeparator():String
public function set thousandsSeparator(value:String):void

Détails du constructeur

()

Constructeur

public function NumberValidator()

Version du langage:

ActionScript 3.0

Version du produit:

Flex 3

Versions du moteur d’exécution:

Flash Player 9, AIR 1.1

Constructeur.

Détails de la méthode

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 un nombre.

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.

Valeur renvoyée

Array — Tableau d’objets ValidationResult, avec un objet ValidationResult pour chaque champ examiné par le programme de validation.

validateNumber

()

méthode

public static function validateNumber(validator:NumberValidator, 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 dans une fonction de validation personnalisée. Chacune des classes Validator Flex standard comporte une méthode pratique similaire.

Paramètres

	`validator:NumberValidator` — Instance NumberValidator.

	`value:Object` — Champ à 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.number, la valeur `baseField` est « number ».

Valeur renvoyée

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

mx.validators.ValidationResult

Exemples Comment utiliser cet exemple

NumberValidatorExample.mxml

<?xml version="1.0" encoding="utf-8"?>
<!-- Simple example to demonstrate the 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:Script>
        import mx.controls.Alert;
    </fx:Script>

    <fx:Declarations>
        <mx:NumberValidator source="{age}" property="text" integerError="Enter Integer value"
                minValue="18" maxValue="50" domain="int" 
                trigger="{myButton}" triggerEvent="click"
                valid="Alert.show('Validation Succeeded!');"
                invalid="Alert.show('Validation failed!');"/>
    </fx:Declarations>

    <s:Panel title="NumberValidator Example"
            width="75%" height="75%"
            horizontalCenter="0" verticalCenter="0">
        <mx:Form left="10" right="10" top="10" bottom="10">
            <mx:FormItem label="Enter an age between 18 and 50:">
                <s:TextInput id="age" width="100%"/>
            </mx:FormItem>
            <mx:FormItem >
                <s:Button id="myButton" label="Validate" />
            </mx:FormItem>
        </mx:Form>
    </s:Panel>

</s:Application>

Informations juridiques | Politique de confidentialité en ligne

NumberValidator - AS3 Flex

Packagesx

Eléments du langage

Annexes

Package mx.validators

allowNegative

decimalPointCountError

decimalSeparator

domain

exceedsMaxError

integerError

invalidCharError

invalidFormatCharsError

lowerThanMinError

maxValue

minValue

negativeError

precision

precisionError

separationError

thousandsSeparator