NumberValidator

Package	spark.validators
Classe	public class NumberValidator
Héritage	NumberValidator 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

La classe NumberValidator garantit qu’un objet String représente un nombre valide conformément aux conventions des paramètres régionaux. Elle peut valider les chaînes qui représentent des objets int, uint et Number.

Cette classe utilise le style locale pour spécifier l’ID de paramètres régionaux demandé.

Le valideur peut s’assurer que l’entrée 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 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.NumberFormatter. Par conséquent, les valeurs spécifiques aux paramètres régionaux sont fournies par le système d’exploitation.

La classe NumberValidator peut être utilisée dans les déclarations MXML ou dans le code ActionScript. Cette classe utilise le style de paramètres régionaux pour spécifier l’ID de paramètres régionaux demandé par la classe flash.globalization.NumberFormatter et possède des méthodes et des propriétés qui sont liables.

Syntaxe MXML expanded

Masquer la syntaxe MXML

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

  <s:NumberValidator
    Properties
    negativeNumberFormat="locale specified string or customized by user."
    negativeNumberFormatError="The negative format of the input number is incorrect."
  />

Consulter les exemples

Eléments de l’API associés

flash.globalization.NumberFormatter

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
		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
		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
		negativeError : String Message d’erreur lorsque la valeur est négative et que la propriété allowNegative est false.	NumberValidatorBase
		negativeNumberFormat : uint Valeur numérique qui indique un modèle de validation pour les nombres négatifs.	NumberValidator
		negativeNumberFormatError : String Message d’erreur lorsque le format de nombre négatif du nombre en entrée ne suit pas le modèle spécifié par la propriété negativeNumberFormat.	NumberValidator
		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
		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

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.	GlobalizationValidatorBase
		actualTrigger : IEventDispatcher [lecture seule] Contient l’objet déclencheur, le cas échéant, ou l’objet source.	GlobalizationValidatorBase
		resourceManager : IResourceManager [lecture seule] Référence à l’objet qui gère toutes les ressources localisées de l’application.	GlobalizationValidatorBase
		subFields : Array Tableau de chaînes contenant les noms des propriétés contenues dans l’objet value transmis à la méthode validate().	GlobalizationValidatorBase

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() Construit un nouvel objet NumberValidator pour valider les nombres en fonction des conventions de paramètres régionaux donnés.	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
		clearStyle(styleProp:String):void Supprime une propriété de style de cette instance de composant.	AdvancedStyleClient
		dispatchEvent(event:Event):Boolean Distribue un événement dans le flux d’événements.	EventDispatcher
		getClassStyleDeclarations():Array 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
		getStyle(styleProp:String):* [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
		hasCSSState():Boolean Renvoie true si la valeur currentCSSState n’est pas nulle.	AdvancedStyleClient
		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 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
		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
		matchesCSSState(cssState:String):Boolean Renvoie la valeur true si cssState correspond à currentCSSState.	AdvancedStyleClient
		matchesCSSType(cssType:String):Boolean Détermine si l’instance est identique au, ou est une sous-classe du, type donné.	AdvancedStyleClient
		notifyStyleChangeInChildren(styleProp:String, recursive:Boolean):void Propage les changements de style aux enfants de cette instance du client de style.	AdvancedStyleClient
		propertyIsEnumerable(name:String):Boolean Indique si la propriété spécifiée existe et est énumérable.	Object
		regenerateStyleCache(recursive:Boolean):void Configure les valeurs de cache du style interne afin que la méthode getStyle() fonctionne.	AdvancedStyleClient
		registerEffects(effects:Array):void Enregistre le gestionnaire EffectManager comme l’un des écouteurs d’événement pour chaque événement d’effet.	AdvancedStyleClient
		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
		setStyle(styleProp:String, newValue:*):void Définit une propriété de style pour cette instance de composant.	AdvancedStyleClient
		styleChanged(styleProp:String):void Détecte les modifications apportées aux propriétés de style.	AdvancedStyleClient
		stylesInitialized():void Flex() appelle la méthode stylesInitialized() lorsque les styles d’un composant sont d’abord initialisés.	AdvancedStyleClient
		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.	GlobalizationValidatorBase
		validateAll(validators:Array):Array [statique] Invoque tous les objets Validator dans le tableau d’objets Validator.	GlobalizationValidatorBase
		validateNumber(value:Object, baseField:String):Array 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.	GlobalizationValidatorBase
		doValidation(value:Object):Array Exécute la logique de validation de ce programme de validation, y compris la validation du fait qu’une classe manquante ou vide provoque une erreur de validation tel que défini par la valeur de la propriété requise.	GlobalizationValidatorBase
		getValueFromSource():Object Renvoie l’objet à valider.	GlobalizationValidatorBase
		handleResults(errorResults:Array):ValidationResultEvent Renvoie une classe ValidationResultEvent depuis le tableau des résultats d’erreurs.	GlobalizationValidatorBase
		isRealValue(value:Object):Boolean Renvoie true si la valeur n’est pas nulle.	GlobalizationValidatorBase
		removeListenerHandler():void Déconnecte tous les écouteurs pour les événements valid et invalid distribués à partir du programme de validation.	GlobalizationValidatorBase
		resourcesChanged():void Cette méthode est appelée lors de la construction d’une classe GlobalizationValidatorBase, puis chaque fois que ResourceManager distribue un événement "change" pour indiquer que les ressources localisées ont subi une modification.	GlobalizationValidatorBase

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
change	L’événement change est généré chaque fois que le style de paramètres régionaux est modifié ou qu’une autre propriété est définie qui entraînerait la modification du format d’un nombre ou la mise à jour des autres valeurs disponibles par le biais de cette classe.	GlobalizationBase
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.	GlobalizationValidatorBase
valid	Distribué si la validation réussit.	GlobalizationValidatorBase

Styles

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.

Styles communs

Cliquez pour plus d’informations sur les styles

Masquer les styles hérités

Afficher les styles hérités

	Style		Description	Défini par
		locale	Type: String Héritage CSS: Oui Version du langage: ActionScript 3.0 Version du produit: Flex 4.5 Versions du moteur d’exécution: Flash10.1, AIR 2.5 Identificateur de paramètres régionaux qui spécifie la langue, la région, le script et éventuellement d’autres balises et touches associées.	GlobalizationBase

Détails de la propriété

negativeNumberFormat

propriété

negativeNumberFormat: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 pour les nombres négatifs. Ce modèle définit l’emplacement du symbole négatif ou des parenthèses par rapport à la partie numérique du nombre à valider.

Le tableau suivant récapitule les formats disponibles pour les nombres négatifs. Lorsqu’un nombre négatif est validé, le signe moins représente la valeur de la propriété negativeSymbol et le caractère ’n’ représente la valeur numérique.

Type de format de nombre négatif	Format
0	(n)
1	-n
2	- n
3	n-
4	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 negativeNumberFormat():uint
public function set negativeNumberFormat(value:uint):void

Valeur émise

ArgumentError — si la valeur assignée n’est pas un numéro compris entre 0 et 4.

Eléments de l’API associés

negativeSymbol
format()

negativeNumberFormatError

propriété

negativeNumberFormatError: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 du nombre en entrée ne suit pas le modèle spécifié par la propriété negativeNumberFormat.

La valeur par défaut est "The negative format of the input number 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 negativeNumberFormatError():String
public function set negativeNumberFormatError(value:String):void

Détails du constructeur

()

Constructeur

public function NumberValidator()

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 NumberValidator pour valider les nombres en fonction des conventions de paramètres régionaux donnés.

Les paramètres régionaux pour cette classe sont fournis par le 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éthode addStyleClient du composant UIComponent.
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:NumberValidator id="nv" />
      </fx:Declarations>
      
```

En utilisant une déclaration MXML et en spécifiant la valeur des paramètres régionaux dans la liste des affectations.

      <fx:Declarations>
          <s:NumberValidator id="nv_French_France" locale="fr_FR" />
      </fx:Declarations>

Appel de la méthode setStyle. Par exemple : nv.setStyle("locale", "fr-FR")

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.

Détails de la méthode

validateNumber

()

méthode

public function validateNumber(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 à valider.

	`baseField:String` — Représentation textuelle du sous-champ spécifié dans l’objet `value`. Par exemple, si le paramètre `value` spécifie value.number, la valeur `baseField` est « number ».

Valeur renvoyée

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

mx.validators.ValidationResult

Exemples Comment utiliser cet exemple

NumberValidatorExample1.mxml

<?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:NumberValidator id="numberValidator" source='{inputNumber}' 
                             property="text" trigger='{validateBtn}'
                             triggerEvent="click" />
        <s:NumberFormatter id="numberFormatter" 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="numberValidator.allowNegative = alowNegative.selected"/>
        </mx:FormItem>
        
        <mx:FormItem label="Fractional Digits">
            <mx:TextInput id="fractionalDigits" text='{numberValidator.fractionalDigits}' 
                          change="numberFormatter.fractionalDigits = 
                          numberValidator.fractionalDigits = Number(fractionalDigits.text)"/>
        </mx:FormItem>
        
        <mx:FormItem label="Actual Locale ID Name">
            <mx:Text text="{numberValidator.actualLocaleIDName}"/>
        </mx:FormItem>
        
        <mx:FormItem label="Input number" >
            <mx:HBox>
                <mx:TextInput id="inputNumber" />
                <mx:Button id="validateBtn" label="Validate" />
            </mx:HBox>
        </mx:FormItem>
        
        <mx:FormItem label="Example number">
            <mx:Text text="{numberFormatter.format(123456789.12)}"/>
        </mx:FormItem>
    </mx:Form>
</s:Application>

Informations juridiques | Politique de confidentialité en ligne

NumberValidator - AS3 Flex

Classes x

negativeNumberFormat

negativeNumberFormatError

NumberValidator

validateNumber