NumberFormatter  - AS3 Flex

Nom de l’identificateur de paramètres régionaux utilisé par cet objet de classe. Il s’agit des paramètres régionaux qui sont utilisés pour accéder à la fonctionnalité et aux données de formatage à partir du système d’exploitation.

Si les paramètres régionaux définis par le style des paramètres régionaux ne sont pas disponibles, la valeur de la propriété actualLocaleIDName est différente de la valeur du style des paramètres régionaux. Elle indique les paramètres régionaux de secours qui sont utilisés. Si le style de paramètres régionaux a été défini sur LocaleID.DEFAULT, le nom des paramètres régionaux spécifié par le système d’exploitation de l’utilisateur est utilisé.

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 .

Eléments de l’API associés

Valeur numérique qui indique un modèle de formatage 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 formaté.

Le tableau suivant récapitule les formats disponibles pour les nombres négatifs. Lorsqu’un nombre négatif est formaté, le signe moins est remplacé par la valeur de la propriété negativeSymbol et le caractère « n » par la valeur numérique formaté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 .

Eléments de l’API associés

Construit un nouvel objet NumberFormatter pour formater les numéros en fonction des conventions de paramètres régionaux donnés.

Les paramètres régionaux pour cette classe sont fournis par le style de paramètres régionaux. Le style de paramètres régionaux peut être défini de plusieurs manières :

• 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. Exemple :

        <fx:Declarations> 
               <s:NumberFormatter id="nf" />
        </fx:Declarations>

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

        <fx:Declarations>
            <s:NumberFormatter id="nf_French_France" locale="fr_FR" />
        </fx:Declarations>

• L’appel de la méthode setStyle. Par exemple :

        nf.setStyle("locale", "fr-FR")

• En héritant le style à partir d’un composant UIComponent en appelant la méthode addStyleClient() du composant UIComponent.

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.

La plupart des propriétés de cette classe sont définies automatiquement en fonction du style de paramètres régionaux. Si le style des paramètres régionaux est modifié, toutes les propriétés qui n’ont pas été explicitement définies seront également mises à jour en fonction des nouveaux paramètres régionaux. Notez que les véritables paramètres régionaux utilisés sont spécifiés par la propriété actualLocaleIDName.

Eléments de l’API associés

Formate un nombre.

Cette fonction formate le nombre en fonction des valeurs de propriété de l’outil de formatage. Si les propriétés ne sont pas modifiées après la définition du style de paramètres régionaux , les nombres sont formatés en fonction des conventions spécifiques aux paramètres régionaux fournies par le système d’exploitation pour les paramètres régionaux identifiés par la propriété actualLocaleIDName. Pour personnaliser le format, les propriétés peuvent être modifiées en vue de contrôler certains aspects de formatage d’un nombre.

Les très grands nombres et les nombres à très petite amplitude peuvent être formatés avec cette fonction. Cependant, le nombre de chiffres significatifs est limité à la précision fournie par l’objet Number. La notation scientifique n’est pas pris en charge.

S’il se produit une erreur lors du formatage, en raison d’une valeur en entrée non valide ou d’une autre erreur, par défaut, la méthode format() renvoie null. Cependant, si la propriété errorText n’a pas la valeur null, la valeur de la propriété errorText est renvoyée. La propriété lastOperationStatus sera définie pour indiquer l’erreur qui s’est produite.

Paramètres

Eléments de l’API associés

Répertorie tous les noms des ID de paramètres régionaux pris en charge par cette classe. Il s’agit de la liste des paramètres régionaux pris en charge par le système d’exploitation, et non d’une liste de paramètres régionaux pour laquelle la classe ResourceManager dispose de ressources.

Analyse une chaîne et renvoie un objet NumberParseResult contenant les éléments analysés.

L’objet NumberParseResult contient la valeur du premier nombre détecté dans la chaîne saisie, l’index de début correspondant au nombre dans la chaîne, et l’index du premier caractère après le nombre dans la chaîne.

Si la chaîne ne contient pas de nombre, la propriété value de l’objet NumberParseResult est définie sur NaN, et les propriétés startIndex et endIndex sont définies sur la valeur hexadécimale 0x7fffffff.

Cette fonction utilise la valeur de la propriété decimalSeparator pour déterminer la partie du nombre contenant les chiffres fractionnaires, la propriété groupingSeparator pour identifier les caractères autorisés dans les chiffres d’un nombre, ainsi que la propriété negativeNumberFormat pour gérer le mode de représentation des valeurs négatives.

Le tableau suivant identifie le résultat des chaînes analysées pour les différentes valeurs de la propriété NegativeNumberFormat :

Un seul espace blanc est autorisé entre le nombre et le signe moins ou la parenthèse. Un espace blanc est un caractère disposant d’une propriété de séparateur d’espace (Zs) dans la base de données des caractères Unicode. Pour plus d’informations, voir http://www.unicode.org/ucd/).

D’autres propriétés sont ignorées pour déterminer si un nombre est valide. Concrètement, la valeur de la propriété digitsType est ignorée et les chiffres peuvent provenir de l’un quelconque des jeux de chiffres énumérés dans la classe NationalDigitsType. Les valeurs des propriétés groupingPattern et useGrouping n’ont aucune incidence sur l’analyse du nombre.

Dans la chaîne, si les nombres sont précédés ou suivis d’un signe plus (+), ce signe est traité comme un caractère ne faisant pas partie du nombre.

Cette fonction n’analyse pas les chaînes contenant des nombres en notation scientifique (par exemple, 1.23e40).

Paramètres

Eléments de l’API associés

      var nf:NumberFormatter = new NumberFormatter();
      nf.setStyle("locale","fr-FR");
      var str:String = "1,56 mètre"
      var result:NumberParseResult = nf.parse(str);
      trace(result.value) // 1.56
      trace(str.substr(0,result.startIndex));                // ""
      trace(str.substr(result.startIndex, result.endIndex)); // "1,56"
      trace(str.substr(result.endIndex));                 // " mètre"
      

Analyse une chaîne qui contient uniquement des chiffres et des espaces facultatifs, et renvoie un nombre. Si la chaîne ne commence pas par un nombre ou contient des caractères autres que des espaces qui ne font pas partie du nombre, cette méthode renvoie NaN. Les espaces blancs avant ou après les chiffres sont ignorés.

Si le chiffre est précédé ou suivi d’un signe plus « + », il est considéré comme un caractère autre qu’un espace blanc. La valeur renvoyée est NaN.

Voir la description de la fonction d’analyse pour plus d’informations sur l’analyse des nombres et les caractéristiques d’un numéro valide.

Paramètres

Eléments de l’API associés