Guide de référence ActionScript® 3.0 pour la plate-forme Adobe® Flash®
Accueil  |  Masquer la liste des packages et des classes |  Packages  |  Classes  |  Nouveautés  |  Index  |  Annexes  |  Pourquoi existe-t-il du contenu en anglais ?
Filtres : Récupération des données du serveur...
Récupération des données du serveur...
mx.validators 

SocialSecurityValidator  - AS3 Flex

Packagemx.validators
Classepublic class SocialSecurityValidator
HéritageSocialSecurityValidator Inheritance Validator Inheritance EventDispatcher Inheritance Object

Version du langage: ActionScript 3.0
Version du produit: Flex 3
Versions du moteur d’exécution: Flash Player 9, AIR 1.1

La classe SocialSecurityValidator valide le fait qu’une chaîne constitue un numéro de sécurité sociale américain valide. Elle ne vérifie pas si elle constitue un numéro de sécurité sociale existant.

Syntaxe MXMLexpandedMasquer la syntaxe MXML

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

  <mx:SocialSecurityValidator
    allowedFormatChars=" -"
    invalidCharError="You entered invalid characters in your Social Security number."
    wrongFormatError="The Social Security number must be 9 digits or in the form NNN-NN-NNNN."
    zeroStartError="Invalid Social Security number; the number cannot start with 000."
  />
  

Consulter les exemples



Propriétés publiques
 PropriétéDéfini par
  allowedFormatChars : String
Spécifie le jeu de caractères de formatage autorisés dans l’entrée.
SocialSecurityValidator
 Inheritedconstructor : Object
Référence à l’objet de classe ou à la fonction constructeur d’une occurrence donnée d’un objet.
Object
 Inheritedenabled : Boolean
Si cette valeur est définie sur false, le programme de validation arrête la validation.
Validator
  invalidCharError : String
Message d’erreur lorsque la valeur contient des caractères autres que des chiffres et des caractères de formatage définis par la propriété allowedFormatChars.
SocialSecurityValidator
 Inheritedlistener : Object
Spécifie l’écouteur de validation.
Validator
 Inheritedproperty : String
Chaîne spécifiant le nom de la propriété de l’objet source qui contient la valeur à valider.
Validator
 Inheritedrequired : Boolean = true
Si true, indique qu’une valeur manquante ou vide provoque une erreur de validation.
Validator
 InheritedrequiredFieldError : String
Message d’erreur lorsqu’une valeur est manquante et que la propriété requise est true.
Validator
 Inheritedsource : Object
Spécifie l’objet contenant la propriété à valider.
Validator
 Inheritedtrigger : IEventDispatcher
Spécifie le composant qui génère l’événement déclenchant le programme de validation.
Validator
 InheritedtriggerEvent : String
Spécifie l’événement qui déclenche la validation.
Validator
  wrongFormatError : String
Message d’erreur lorsque la valeur n’est pas correctement formatée.
SocialSecurityValidator
  zeroStartError : String
Message d’erreur lorsque la valeur contient un numéro de sécurité sociale non valide.
SocialSecurityValidator
Propriétés protégées
 PropriétéDéfini par
 InheritedactualListeners : Array
[lecture seule] Contient un tableau d’objets d’écouteurs, le cas échéant, ou l’objet source.
Validator
 InheritedactualTrigger : IEventDispatcher
[lecture seule] Contient l’objet déclencheur, le cas échéant, ou l’objet source.
Validator
 InheritedresourceManager : IResourceManager
[lecture seule] Référence à l’objet qui gère toutes les ressources localisées de l’application.
Validator
 InheritedsubFields : 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
 MéthodeDéfini par
  
Constructeur.
SocialSecurityValidator
 Inherited
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
 Inherited
Distribue un événement dans le flux d’événements.
EventDispatcher
 Inherited
Vérifie si des écouteurs sont enregistrés auprès de l’objet EventDispatcher pour un type spécifique d’événement.
EventDispatcher
 Inherited
Indique si la propriété spécifiée d’un objet est définie.
Object
 Inherited
Appelé automatiquement par le compilateur MXML lorsque la classe Validator est créée à l’aide d’une balise MXML.
Validator
 Inherited
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
 Inherited
Indique si la propriété spécifiée existe et est énumérable.
Object
 Inherited
removeEventListener(type:String, listener:Function, useCapture:Boolean = false):void
Supprime un écouteur de l’objet EventDispatcher.
EventDispatcher
 Inherited
Définit la disponibilité d’une propriété dynamique pour les opérations en boucle.
Object
 Inherited
Renvoie la représentation de chaîne de cet objet, formatée selon les paramètres régionaux en vigueur.
Object
 Inherited
Renvoie la représentation sous forme de chaîne de l’objet spécifié.
Object
 Inherited
validate(value:Object = null, suppressEvents:Boolean = false):ValidationResultEvent
Procède à la validation et, le cas échéant, informe les écouteurs du résultat.
Validator
 Inherited
validateAll(validators:Array):Array
[statique] Invoque tous les objets Validator dans le tableau d’objets Validator.
Validator
  
[statique] Méthode pratique pour appeler une classe Validator.
SocialSecurityValidator
 Inherited
Renvoie la valeur primitive de l’objet spécifié.
Object
 Inherited
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
 MéthodeDéfini par
 Inherited
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 un numéro de sécurité sociale.
SocialSecurityValidator
 Inherited
Renvoie l’objet à valider.
Validator
 Inherited
Renvoie une classe ValidationResultEvent depuis le tableau des résultats d’erreurs.
Validator
 Inherited
Renvoie true si la valeur n’est pas nulle.
Validator
 Inherited
Déconnecte tous les écouteurs pour les événements valid et invalid distribués à partir du programme de validation.
Validator
 Inherited
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
 Evénement Synthèse Défini par
 Inherited[Evénement de diffusion] Distribué lorsque l’application Flash Player obtient le focus du système d’exploitation et devient active.EventDispatcher
 Inherited[Evénement de diffusion] Distribué lorsque l’application Flash Player ou AIR perd le focus du système d’exploitation et devient inactive.EventDispatcher
 InheritedDistribué si la validation échoue.Validator
 InheritedDistribué si la validation réussit.Validator
Détails de la propriété

allowedFormatChars

propriété
allowedFormatChars: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 le jeu de caractères de formatage autorisés dans l’entrée.

La valeur par défaut est "()- .+" // ?????.



Implémentation
    public function get allowedFormatChars():String
    public function set allowedFormatChars(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 autres que des chiffres et des caractères de formatage définis par la propriété allowedFormatChars.

La valeur par défaut est "You entered invalid characters in your Social Security number.".



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

wrongFormatError

propriété 
wrongFormatError: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 n’est pas correctement formatée.

La valeur par défaut est "The Social Security number must be 9 digits or in the form NNN-NN-NNNN.".



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

zeroStartError

propriété 
zeroStartError: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 numéro de sécurité sociale non valide.

La valeur par défaut est "Invalid Social Security number; the number cannot start with 000.".



Implémentation
    public function get zeroStartError():String
    public function set zeroStartError(value:String):void
Détails du constructeur

SocialSecurityValidator

()Constructeur
public function SocialSecurityValidator()

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 numéro de sécurité sociale.

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.

validateSocialSecurity

()méthode 
public static function validateSocialSecurity(validator:SocialSecurityValidator, 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:SocialSecurityValidator — Instance SocialSecurityValidator.
 
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.social, la valeur baseField est social.

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

SocialSecurityValidatorExample.mxml
<?xml version="1.0" encoding="utf-8"?>
<!-- Simple example to demonstrate SocialSecurityValidator. -->
<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:SocialSecurityValidator source="{ssn}" property="text" 
                trigger="{myButton}" triggerEvent="click"
                valid="Alert.show('Validation Succeeded!');"
                invalid="Alert.show('Validation Failed!');"/>
    </fx:Declarations>

    <s:Panel title="Social Security Validator Panel"
            width="75%" height="75%"
            horizontalCenter="0" verticalCenter="0">
        <mx:Form left="10" right="10" top="10" bottom="10">
            <mx:FormItem label="Enter Social Security number: ">
                <s:TextInput id="ssn" width="100%"/>
            </mx:FormItem>
            <mx:FormItem >
                <s:Button id="myButton" label="Validate" />
            </mx:FormItem>
        </mx:Form>
    </s:Panel>

</s:Application>




[ X ]Pourquoi existe-t-il du contenu en anglais ?
Certaines parties du Guide de référence ActionScript 3.0 sont en anglais

Tout le contenu du Guide de référence ActionScript 3.0 n’a pas été traduit dans toutes les langues. Si un élément de langage n’est pas traduit, il s’affiche en anglais. Par exemple, la classe ga.controls.HelpBox n’est traduite dans aucune langue. Ainsi, dans la version française du guide de référence, la classe ga.controls.HelpBox apparaît en anglais.