| Package | spark.validators.supportClasses |
| Classe | public class GlobalizationValidatorBase |
| Héritage | GlobalizationValidatorBase  GlobalizationBase AdvancedStyleClient EventDispatcher Object |
| Implémente | IValidator |
| Sous-classes | NumberValidatorBase |
| 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 |
Afficher la syntaxe MXML
Masquer la syntaxe MXMLThe <s:GlobalizationValidatorBase> tag
inherits all of the tag attributes of its superclass,
and adds the following tag attributes:
<s:GlobalizationValidatorBase
Properties
enabled="true"
listener="Value of the source property"
property="No default"
required="true"
requiredFieldError="This field is required."
source="No default"
trigger="Value of the source property"
triggerEvent="valueCommit"
Events
invalid="No default"
valid="No default"
/>
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 | |
| 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 | |
| enabled : Boolean
Si cette valeur est définie sur false, le programme de validation arrête la validation. | GlobalizationValidatorBase | ||
| id : String
Identité du composant. | AdvancedStyleClient | |
| inheritingStyles : Object
Objet contenant les styles héritables de cette instance de client de style non visuel. | AdvancedStyleClient | |
| lastOperationStatus : String [lecture seule]
Etat de la dernière opération que cet objet de classe a effectuée. | GlobalizationBase | |
| listener : Object
Spécifie l’écouteur de validation. | GlobalizationValidatorBase | ||
| 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 | |
| nonInheritingStyles : Object
Début de la chaîne de styles non hérités de ce composant. | AdvancedStyleClient | |
| 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é | 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éthode | Défini par | ||
|---|---|---|---|
Constructeur. | GlobalizationValidatorBase | ||
| 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 | ||
|
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. | GlobalizationValidatorBase | ||
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 | ||
Renvoie l’objet à valider. | GlobalizationValidatorBase | ||
Renvoie une classe ValidationResultEvent depuis le tableau des résultats d’erreurs. | GlobalizationValidatorBase | ||
Renvoie true si la valeur n’est pas nulle. | GlobalizationValidatorBase | ||
Déconnecte tous les écouteurs pour les événements valid et invalid distribués à partir du programme de validation. | GlobalizationValidatorBase | ||
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énement | Synthèse | Défini par | ||
|---|---|---|---|---|
| [Evénement de diffusion] Distribué lorsque l’application Flash Player obtient le focus du système d’exploitation et devient active. | EventDispatcher | ||
| 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 | ||
| [Evénement de diffusion] Distribué lorsque l’application Flash Player ou AIR perd le focus du système d’exploitation et devient inactive. | EventDispatcher | ||
| Distribué si la validation échoue. | GlobalizationValidatorBase | |||
| Distribué si la validation réussit. | GlobalizationValidatorBase | |||
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.
actualListeners | propriété |
actualListeners:Array [lecture seule] | 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 |
Contient un tableau d’objets d’écouteurs, le cas échéant, ou l’objet source. Permet de déterminer quel objet informer du résultat de validation.
Implémentation
protected function get actualListeners():ArrayactualTrigger | propriété |
actualTrigger:IEventDispatcher [lecture seule] | 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 |
Contient l’objet déclencheur, le cas échéant, ou l’objet source. Permet de déterminer l’objet d’écouteur de l’événement triggerEvent.
Implémentation
protected function get actualTrigger():IEventDispatcherenabled | propriété |
enabled:Boolean| 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 |
Si cette valeur est définie sur false, le programme de validation arrête la validation. Lorsqu’un programme de validation est désactivé, il ne distribue aucun événement et la méthode validate() renvoie null.
La valeur par défaut est true.
Implémentation
public function get enabled():Boolean public function set enabled(value:Boolean):voidlistener | propriété |
listener: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 |
Spécifie l’écouteur de validation.
Si vous ne spécifiez aucun écouteur, Flex utilise la valeur de la propriété source. Une fois que Flex a déterminé le composant source, il en change la couleur de bordure, affiche un message d’erreur pour un échec ou masque tout message d’erreur existant pour une validation réussie.
Implémentation
public function get listener():Object public function set listener(value:Object):voidproperty | propriété |
property: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 spécifiant le nom de la propriété de l’objet source qui contient la valeur à valider. Cette propriété est facultative, mais si vous spécifiez la propriété source, définissez également une valeur pour cette propriété.
La valeur par défaut est null.
Implémentation
public function get property():String public function set property(value:String):voidrequired | propriété |
public var required:Boolean = true| 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 |
Si true, indique qu’une valeur manquante ou vide provoque une erreur de validation.
La valeur par défaut est true.
requiredFieldError | propriété |
requiredFieldError: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 lorsqu’une valeur est manquante et que la propriété requise est true.
La valeur par défaut est "This field is required.".
Implémentation
public function get requiredFieldError():String public function set requiredFieldError(value:String):voidresourceManager | propriété |
resourceManager:IResourceManager [lecture seule] | 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 |
Référence à l’objet qui gère toutes les ressources localisées de l’application. Il s’agit d’une instance Singleton qui implémente l’interface IResourceManager.
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 unused .
Implémentation
protected function get resourceManager():IResourceManagersource | propriété |
source: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 |
Spécifie l’objet contenant la propriété à valider. Définissez ceci sur une instance d’un composant ou d’un modèle de données. Utilisez la syntaxe de liaison de données dans MXML pour spécifier la valeur. Cette propriété prend en charge les chaînes séparées par des points pour spécifier des propriétés imbriquées. Si vous spécifiez une valeur pour la propriété source, vous devez aussi en spécifier une pour la propriété property. La propriété source est facultative.
La valeur par défaut est null.
Implémentation
public function get source():Object public function set source(value:Object):voidsubFields | propriété |
protected var subFields: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 |
Tableau de chaînes contenant les noms des propriétés contenues dans l’objet value transmis à la méthode validate(). Par exemple, CreditCardValidator définit cette propriété sur [ "cardNumber", "cardType" ]. Cette valeur signifie que l’objet value transmis à la méthode validate() doit contenir une propriété cardNumber et cardType.
trigger | propriété |
trigger:IEventDispatcher| 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 |
Spécifie le composant qui génère l’événement déclenchant le programme de validation. Si omis, Flex utilise par défaut la valeur de la propriété source. Lorsque le déclencheur distribue un événement triggerEvent, la validation s’exécute.
Implémentation
public function get trigger():IEventDispatcher public function set trigger(value:IEventDispatcher):voidtriggerEvent | propriété |
triggerEvent: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 |
Spécifie l’événement qui déclenche la validation. Si omis, Flex utilise l’événement valueCommit. Flex distribue l’événement valueCommit lorsqu’un utilisateur entre des données dans un contrôle. Cela se produit généralement lorsque l’utilisateur supprime le focus du composant ou lorsqu’une valeur de propriété est changée par programmation. Si vous voulez qu’un programme de validation ignore tous les événements, définissez triggerEvent sur la chaîne vide ("").
Implémentation
public function get triggerEvent():String public function set triggerEvent(value:String):voidGlobalizationValidatorBase | () | Constructeur |
public function GlobalizationValidatorBase()| 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 |
Constructeur.
addListenerHandler | () | méthode |
protected function addListenerHandler():void| 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 |
Définit tous les écouteurs pour les événements valid et invalid distribués à partir du programme de validation. Les sous-classes de la classe GlobalizationValidatorBase doivent d’abord appeler la méthode removeListenerHandler(), puis la méthode addListenerHandler() si la valeur de l’un de leurs écouteurs ou de l’une de leurs sources change. Les classes CreditCardValidator et DateValidator utilisent cette fonction de manière interne.
doValidation | () | méthode |
protected function doValidation(value:Object):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 |
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.
Si vous créez une sous-classe d’une classe Validator, vous devez remplacer cette méthode.
Paramètres
value:Object — Valeur à valider.
|
Array — Pour un résultat non valide, tableau d’objets ValidationResult, avec un objet ValidationResult pour chaque champ examiné par le programme de validation ayant échoué à la validation.
|
Eléments de l’API associés
getValueFromSource | () | méthode |
handleResults | () | méthode |
protected function handleResults(errorResults:Array):ValidationResultEvent| 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 |
Renvoie une classe ValidationResultEvent depuis le tableau des résultats d’erreurs. En interne, cette fonction extrait les résultats de la méthode doValidation() pour les insérer dans un objet ValidationResultEvent. Vous n’appelez jamais cette fonction directement et ne devez la remplacez que rarement.
Paramètres
errorResults:Array — Tableau des objets ValidationResult.
|
ValidationResultEvent — Classe ValidationResultEvent renvoyée par la méthode validate().
|
isRealValue | () | méthode |
protected function isRealValue(value:Object):Boolean| 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 |
Renvoie true si la valeur value n’est pas nulle.
Paramètres
value:Object — Valeur à tester.
|
Boolean — Renvoie true si la valeur value n’est pas nulle.
|
removeListenerHandler | () | méthode |
protected function removeListenerHandler():void| 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 |
Déconnecte tous les écouteurs pour les événements valid et invalid distribués à partir du programme de validation. Les sous-classes doivent d’abord appeler la méthode removeListenerHandler(), puis la méthode addListenerHandler si la valeur de l’un de leurs écouteurs ou de l’une de leurs sources change. Les classes CreditCardValidator et DateValidator utilisent cette fonction de manière interne.
resourcesChanged | () | méthode |
protected function resourcesChanged():void| 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 |
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.
Cet événement est distribué lorsque vous définissez la propriété localeChain de la classe ResourceManager, lorsqu’un module de ressource termine de se charger et lorsque vous appelez la méthode update() de la classe ResourceManager.
Les sous-classes doivent remplacer cette méthode et, après avoir appelé la méthode super.resourcesChanged(), effectuer les tâches appropriées en réponse aux nouvelles valeurs de ressources.
validate | () | méthode |
public function validate(value:Object = null, suppressEvents:Boolean = false):ValidationResultEvent| 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 |
Procède à la validation et, le cas échéant, informe les écouteurs du résultat.
Paramètres
value:Object (default = null)source et property pour déterminer la valeur. Si vous spécifiez cet argument, vous devez aussi définir la propriété listener afin de spécifier le composant cible pour les messages d’erreur de validation.
| |
suppressEvents:Boolean (default = false)false, après la validation, le programme de validation informe l’écouteur du résultat.
|
ValidationResultEvent — Objet ValidationResultEvent contenant les résultats de la validation. Pour une validation réussie, la propriété de tableau ValidationResultEvent.results est vide. Pour un échec de validation, la propriété de tableau ValidationResultEvent.results contient un objet ValidationResult pour chaque champ vérifié par le programme de validation, à la fois pour les champs ayant réussi à la validation et pour ceux ayant échoué. Examine la propriété ValidationResult.isError pour déterminer si le champ a réussi ou échoué à la validation.
|
Eléments de l’API associés
validateAll | () | méthode |
public static function validateAll(validators:Array):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 |
Invoque tous les objets Validator dans le tableau d’objets Validator. Renvoie un tableau contenant un objet ValidationResultEvent pour chaque objet Validator ayant échoué. Renvoie un tableau vide si tous les objets Validator ont réussi.
Paramètres
validators:Array — Tableau contenant les objets GlobalizationValidatorBase à exécuter.
|
Array — Tableau d’objets ValidationResultEvent, qui contient un objet ValidationResultEvent pour chaque objet Validator ayant échoué. Le tableau est vide si tous les objets Validator ont réussi.
|
invalid | Evénement |
mx.events.ValidationResultEventpropriété ValidationResultEvent.type =
mx.events.ValidationResultEvent.INVALID| 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 |
Distribué si la validation échoue.
La constanteValidationResultEvent.INVALID définit la valeur de la propriété type de l’objet d’événement d’un événement invalid. La valeur de cette constante est « invalid ».
Les valeurs des propriétés de l’objet d’événement sont les suivantes :
| Propriété | Valeur |
|---|---|
bubbles | false |
cancelable | false |
currentTarget | Objet définissant l’écouteur d’événement qui traite l’événement. Par exemple, si vous utilisez myButton.addEventListener() pour enregistrer un écouteur d’événement, myButton est la valeur de currentTarget. |
field | Nom du champ dont la validation a échoué. |
message | Chaîne unique contenant tous les messages d’erreur issus de tous les objets ValidationResult du tableau de résultats. |
results | Tableau d’objets ValidationResult (un par champ validé). |
target | Objet qui a distribué l’événement (il ne s’agit pas toujours de l’objet qui écoute l’événement). Pour accéder systématiquement à l’objet qui écoute l’événement, utilisez la propriété currentTarget. |
valid | Evénement |
mx.events.ValidationResultEventpropriété ValidationResultEvent.type =
mx.events.ValidationResultEvent.VALID| 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 |
Distribué si la validation réussit.
La constanteValidationResultEvent.VALID définit la valeur de la propriété type de l’objet d’événement d’un événement valid. La valeur de cette constante est « valid ».
Les valeurs des propriétés de l’objet d’événement sont les suivantes :
| Propriété | Valeur |
|---|---|
bubbles | false |
cancelable | false |
currentTarget | Objet définissant l’écouteur d’événement qui traite l’événement. Par exemple, si vous utilisez myButton.addEventListener() pour enregistrer un écouteur d’événement, myButton est la valeur de currentTarget. |
field | Chaîne vide. |
message | Chaîne vide. |
results | Tableau vide. |
target | Objet qui a distribué l’événement (il ne s’agit pas toujours de l’objet qui écoute l’événement). Pour accéder systématiquement à l’objet qui écoute l’événement, utilisez la propriété currentTarget. |
Tue Jun 12 2018, 09:30 AM Z