| Package | spark.formatters.supportClasses |
| Classe | public class NumberFormatterBase |
| Héritage | NumberFormatterBase  GlobalizationBase AdvancedStyleClient EventDispatcher Object |
| Sous-classes | CurrencyFormatter, NumberFormatter |
| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 4.5 |
| Versions du moteur d’exécution: | Flash Player 10, AIR 2.5 |
Afficher la syntaxe MXML
Masquer la syntaxe MXMLThe <s:NumberFormatterBase> tag inherits all of the tag
attributes of its superclass and adds the following tag attributes:
<s:NumberFormatterBase
Properties
decimalSeparator="locale and OS dependent"
digitsType="locale and OS dependent"
errorText="null"
fractionalDigits="locale and OS dependent"
groupingPattern="locale and OS dependent"
groupingSeparator="locale and OS dependent"
leadingZero="locale and OS dependent"
negativeSymbol="locale and OS dependent"
trailingZeros="locale and OS dependent"
useGrouping="locale and OS dependent"
/>
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 | |
| decimalSeparator : String
Le séparateur décimal utilisé pour le formatage ou l’analyse des nombres ayant une partie décimale. | NumberFormatterBase | ||
| digitsType : uint
Définit le jeu de caractères numériques à utiliser lors du formatage des nombres. | NumberFormatterBase | ||
| errorText : String
Chaîne de remplacement renvoyée par la méthode format() lorsqu’une erreur se produit. | NumberFormatterBase | ||
| fractionalDigits : int
Nombre maximal de chiffres pouvant apparaître après le séparateur décimal. | NumberFormatterBase | ||
| groupingPattern : String
Décrit le placement des séparateurs de groupes dans la chaîne de nombres formatée. | NumberFormatterBase | ||
| groupingSeparator : String
Caractère ou chaîne utilisé(e) pour le séparateur de groupes. | NumberFormatterBase | ||
| 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 [override] [lecture seule]
Etat de la dernière opération que cet objet de classe a effectuée. | NumberFormatterBase | ||
| leadingZero : Boolean
Indique si un nombre est précédé d’un zéro lorsque celui-ci ne contient aucun nombre entier à gauche du séparateur décimal. | NumberFormatterBase | ||
| 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 | |
| negativeSymbol : String
Symbole négatif à utiliser lors du formatage des valeurs négatives. | NumberFormatterBase | ||
| nonInheritingStyles : Object
Début de la chaîne de styles non hérités de ce composant. | AdvancedStyleClient | |
| 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 | |
| trailingZeros : Boolean
Indique si un nombre formaté est précédé de zéros. | NumberFormatterBase | ||
| useGrouping : Boolean
Permet l’utilisation du séparateur de groupes lors du formatage des nombres. | NumberFormatterBase | ||
| Méthode | Défini par | ||
|---|---|---|---|
Constructeur. | NumberFormatterBase | ||
| 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 | |
|
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.
decimalSeparator | propriété |
decimalSeparator:String| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 4.5 |
| Versions du moteur d’exécution: | Flash Player 10, AIR 2.5 |
Le séparateur décimal utilisé pour le formatage ou l’analyse des nombres ayant une partie décimale.
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 decimalSeparator():String public function set decimalSeparator(value:String):voidValeur émise
TypeError — si cette propriété se voit attribuer une valeur null.
|
Eléments de l’API associés
digitsType | propriété |
digitsType:uint| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 4.5 |
| Versions du moteur d’exécution: | Flash Player 10, AIR 2.5 |
Définit le jeu de caractères numériques à utiliser lors du formatage des nombres.
Selon les langues et les régions, différents jeux de caractères sont utilisés pour représenter les chiffres de 0 à 9. Cette propriété définit le jeu de chiffres à utiliser.
La valeur de cette propriété représente la valeur Unicode pour le chiffre zéro d’un jeu de chiffres décimaux. Les valeurs valides de cette propriété sont définies dans la classe NationalDigitsType.
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 digitsType():uint public function set digitsType(value:uint):voidEléments de l’API associés
errorText | propriété |
errorText:String| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 4.5 |
| Versions du moteur d’exécution: | Flash Player 10, AIR 2.5 |
Chaîne de remplacement renvoyée par la méthode format() lorsqu’une erreur se produit.
Si la propriété errorText n’a pas la valeur null et qu’une erreur se produit lors de la mise en forme d’un nombre ou d’un montant en devise, la méthode format renverra la chaîne affectée à cette propriété.
var nf:NumberFormatter = new NumberFormatter();
nf.setStyle("locale", "en-US");
nf.errorText = "###"
trace(nf.format("abc")); // ###
La valeur par défaut est null.
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 errorText():String public function set errorText(value:String):voidEléments de l’API associés
fractionalDigits | propriété |
fractionalDigits:int| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 4.5 |
| Versions du moteur d’exécution: | Flash Player 10, AIR 2.5 |
Nombre maximal de chiffres pouvant apparaître après le séparateur décimal.
Les numéros sont arrondis au nombre de chiffres spécifié par cette propriété. Le modèle d’arrondi varie selon le système d’exploitation de l’utilisateur de l’application.
Lorsque la propriété trailingZeros est définie sur true, la partie fractionnaire du nombre (après le séparateur décimal) est complétée par des zéros non significatifs jusqu’à ce que sa longueur corresponde à la valeur de cette propriété fractionalDigits.
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 fractionalDigits():int public function set fractionalDigits(value:int):voidEléments de l’API associés
groupingPattern | propriété |
groupingPattern:String| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 4.5 |
| Versions du moteur d’exécution: | Flash Player 10, AIR 2.5 |
Décrit le placement des séparateurs de groupes dans la chaîne de nombres formatée.
Lorsque la propriété useGrouping est définie sur true, la propriété groupingPattern permet de définir le placement et le modèle utilisé pour le séparateur de groupes.
Le modèle de groupement est défini en tant que chaîne contenant des numéros séparés par des points-virgules et pouvant se terminer par un astérisque. Par exemple : "3;2;*". Chaque numéro dans la chaîne représente le nombre de chiffres dans un groupe. Le séparateur de groupes est placé avant chaque groupe de chiffres. Un astérisque à la fin de la chaîne indique que les groupes avec ce nombre de chiffres doivent être répétés pour le reste de la chaîne formatée. S’il n’y a pas d’astérisque, il n’y a aucun groupe ou séparateur supplémentaire pour le reste de la chaîne formatée.
Le premier nombre dans la chaîne correspond au premier groupe de chiffres à gauche du séparateur décimal. Les nombres suivants définissent le nombre de chiffres dans les groupes suivants se trouvant à gauche. Ainsi, la chaîne "3;2;*" indique qu’un séparateur de groupes est placé après le premier groupe de 3 chiffres, suivi par des groupes de 2 chiffres. Par exemple : 98,76,54,321
Le tableau ci-dessous présente des exemples de formatage du nombre 123456789.12 avec divers modèles de groupement. Le séparateur de groupes est une virgule et le séparateur décimal est un point.
| Modèle de groupement | Exemple de format |
3;* | 123,456,789.12 |
3;2;* | 12,34,56,789.12 |
3 | 123456,789.12 |
Seul un nombre limité de tailles de groupement peut être défini. Sur certains systèmes d’exploitation, les modèles de groupement ne peuvent contenir que deux nombres et un astérisque. D’autres systèmes d’exploitation peuvent prendre en charge jusqu’à quatre nombres et un astérisque. Pour les modèles sans astérisque, certains systèmes d’exploitation ne prennent en charge qu’un seul nombre, alors que d’autres prennent en charge jusqu’à trois nombres. Si le nombre maximal d’éléments de modèle de groupement est dépassé, d’autres éléments sont ignorés et la propriété lastOperationStatus est définie pour indiquer qu’une valeur de secours est utilisée.
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 groupingPattern():String public function set groupingPattern(value:String):voidValeur émise
TypeError — si cette propriété se voit attribuer une valeur null.
|
Eléments de l’API associés
groupingSeparator | propriété |
groupingSeparator:String| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 4.5 |
| Versions du moteur d’exécution: | Flash Player 10, AIR 2.5 |
Caractère ou chaîne utilisé(e) pour le séparateur de groupes.
La valeur de cette propriété est utilisée comme séparateur de groupes lors du formatage des nombres lorsque la propriété useGrouping est définie sur true. Cette propriété est initialement définie en fonction des paramètres régionaux sélectionnés lors de la construction de l’objet formatter.
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 groupingSeparator():String public function set groupingSeparator(value:String):voidValeur émise
TypeError — si cette propriété se voit attribuer une valeur null.
|
Eléments de l’API associés
lastOperationStatus | propriété |
lastOperationStatus:String [lecture seule] [override] | Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 4.5 |
| Versions du moteur d’exécution: | Flash Player 10, AIR 2.5 |
Etat de la dernière opération que cet objet de classe a effectuée. La propriété lastOperationStatus est définie chaque fois que le constructeur ou une méthode de cette classe est appelé, ou qu’une autre propriété est définie. Pour les valeurs disponibles, voir la description de chaque méthode.
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
override public function get lastOperationStatus():StringleadingZero | propriété |
leadingZero:Boolean| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 4.5 |
| Versions du moteur d’exécution: | Flash Player 10, AIR 2.5 |
Indique si un nombre est précédé d’un zéro lorsque celui-ci ne contient aucun nombre entier à gauche du séparateur décimal.
Lorsque cette propriété est définie sur true, un zéro est inséré à gauche du séparateur décimal lors du formatage des valeurs numériques comprises entre -1,0 et 1,0. Lorsque cette propriété est définie sur false, aucun zéro n’est inséré.
Par exemple, si le nombre est 0,321 et que cette propriété est définie sur true, le zéro à gauche est inclus dans la chaîne formatée. Si la propriété est définie sur false, le zéro n’est inclus. Dans ce cas, la chaîne inclut uniquement le séparateur décimal, suivi des chiffres décimaux, tels que ,321.
Le tableau ci-dessous présente des exemples sur la façon dont les nombres sont formatés en fonction des valeurs de cette propriété, ainsi que des propriétés fractionalDigits et trailingZeros associées.
| trailingZeros | leadingZero | fractionalDigits | 0.12 | 0 |
| true | true | 3 | 0.120 | 0.000 |
| false | true | 3 | 0.12 | 0 |
| true | false | 3 | .120 | .000 |
| false | false | 3 | .12 | 0 |
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 leadingZero():Boolean public function set leadingZero(value:Boolean):voidValeur émise
TypeError — si cette propriété se voit attribuer une valeur null.
|
Eléments de l’API associés
negativeSymbol | propriété |
negativeSymbol:String| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 4.5 |
| Versions du moteur d’exécution: | Flash Player 10, AIR 2.5 |
Symbole négatif à utiliser lors du formatage des valeurs négatives.
Ce symbole est utilisé avec le format de nombre négatif lors du formatage d’un nombre inférieur à zéro. Il n’est pas utilisé dans des formats de nombre négatif qui n’incluent pas de signe négatif (notamment lorsque des nombres négatifs se trouvent entre parenthèses).
Cette propriété est définie sur une valeur par défaut pour les paramètres régionaux sélectionnés lors de la construction de cette classe de formatage. Elle peut être définie sur une valeur de façon à remplacer le paramètre par défaut.
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 negativeSymbol():String public function set negativeSymbol(value:String):voidEléments de l’API associés
trailingZeros | propriété |
trailingZeros:Boolean| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 4.5 |
| Versions du moteur d’exécution: | Flash Player 10, AIR 2.5 |
Indique si un nombre formaté est précédé de zéros.
Lorsque cette propriété est définie sur true, des zéros sont insérés à droite de la partie fractionnaire du nombre formaté, en respectant la limite spécifiée par la propriété fractionalDigits. Lorsque cette propriété est définie sur false, aucun zéro n’est inséré.
Par exemple, si la valeur numérique est 123,4 et que cette propriété est définie sur true, et si la propriété fractionalDigits est définie sur 3, la chaîne formatée comporte des zéros à droite, comme suit : 123,400. Si cette propriété est définie sur false, aucun zéro à droite n’est inclus et la chaîne comporte uniquement le séparateur décimal suivi des chiffres décimaux non nuls, comme suit : 123,4.
Le tableau ci-dessous présente des exemples sur la façon dont les valeurs numériques sont formatées en fonction des valeurs de cette propriété, ainsi que des propriétés fractionalDigits et trailingZeros associées.
| trailingZeros | leadingZero | fractionalDigits | 0.12 | 0 |
| true | true | 3 | 0.120 | 0.000 |
| false | true | 3 | 0.12 | 0 |
| true | false | 3 | .120 | .000 |
| false | false | 3 | .12 | 0 |
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 trailingZeros():Boolean public function set trailingZeros(value:Boolean):voidValeur émise
TypeError — si cette propriété se voit attribuer une valeur null.
|
Eléments de l’API associés
useGrouping | propriété |
useGrouping:Boolean| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 4.5 |
| Versions du moteur d’exécution: | Flash Player 10, AIR 2.5 |
Permet l’utilisation du séparateur de groupes lors du formatage des nombres.
Lorsque la propriété useGrouping est définie sur true, les chiffres sont groupés et délimités par le caractère de séparation de groupes. Par exemple : 123,456,789.22
Lorsque la propriété useGrouping est définie sur false, les chiffres ne sont ni groupés ni séparés. Par exemple : 123456789.22
Le symbole à utiliser en tant que séparateur de groupes est défini par la propriété groupingSeparator. Le nombre de chiffres compris entre les séparateurs de groupes est défini par la propriété groupingPattern.
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 useGrouping():Boolean public function set useGrouping(value:Boolean):voidEléments de l’API associés
NumberFormatterBase | () | Constructeur |
public function NumberFormatterBase()| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 4.5 |
| Versions du moteur d’exécution: | Flash Player 10, AIR 2.5 |
Constructeur.
Tue Jun 12 2018, 09:30 AM Z