| Package | mx.formatters |
| Classe | public class Formatter |
| Héritage | Formatter  Object |
| Implémente | IFormatter |
| Sous-classes | CurrencyFormatter, DateFormatter, NumberFormatter, PhoneFormatter, ZipCodeFormatter |
| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 3 |
| Versions du moteur d’exécution: | Flash Player 9, AIR 1.1 |
format().
Syntaxe MXML
Afficher la syntaxe MXML
Masquer la syntaxe MXMLThe Formatter class defines the following tag attributes, which all of its subclasses inherit:
<mx:tagname
Properties
error=""
/>
| Propriété | Défini par | ||
|---|---|---|---|
 | constructor : Object
Référence à l’objet de classe ou à la fonction constructeur d’une occurrence donnée d’un objet. | Object | |
| defaultInvalidFormatError : String [statique]
Message d’erreur indiquant qu’une chaîne de format non valide a été transmise à la classe de formatage. | Formatter | ||
| defaultInvalidValueError : String [statique]
Messages d’erreur indiquant qu’une valeur non valide a été transmise à la classe de formatage. | Formatter | ||
| error : String
Description enregistrée par la classe de formatage lorsqu’une erreur survient. | Formatter | ||
| Propriété | Défini par | ||
|---|---|---|---|
| resourceManager : IResourceManager [lecture seule]
Référence à l’objet qui gère toutes les ressources localisées de l’application. | Formatter | ||
| Méthode | Défini par | ||
|---|---|---|---|
Constructeur. | Formatter | ||
Formate une valeur et renvoie une chaîne contenant la nouvelle valeur formatée. | Formatter | ||
|
Indique si la propriété spécifiée d’un objet est définie. | Object | |
|
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 | |
|
Indique si la propriété spécifiée existe et est énumérable. | Object | |
|
Définit la disponibilité d’une propriété dynamique pour les opérations en boucle. | Object | |
|
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 | |
| Méthode | Défini par | ||
|---|---|---|---|
Cette méthode est appelée lors de la construction d’une classe Formatter, puis chaque fois que ResourceManager envoie un événement "change" pour indiquer que les ressources localisées ont subi une modification. | Formatter | ||
defaultInvalidFormatError | propriété |
defaultInvalidFormatError: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 indiquant qu’une chaîne de format non valide a été transmise à la classe de formatage.
La valeur par défaut est "Invalid format".
Implémentation
public static function get defaultInvalidFormatError():String public static function set defaultInvalidFormatError(value:String):voiddefaultInvalidValueError | propriété |
defaultInvalidValueError:String| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 3 |
| Versions du moteur d’exécution: | Flash Player 9, AIR 1.1 |
Messages d’erreur indiquant qu’une valeur non valide a été transmise à la classe de formatage.
La valeur par défaut est "Invalid value".
Implémentation
public static function get defaultInvalidValueError():String public static function set defaultInvalidValueError(value:String):voiderror | propriété |
public var error:String| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 3 |
| Versions du moteur d’exécution: | Flash Player 9, AIR 1.1 |
Description enregistrée par la classe de formatage lorsqu’une erreur survient. Pour connaître les valeurs autorisées pour cette propriété, voir la description de chaque classe de formatage.
Les sous-classes doivent définir cette valeur dans la méthode format().
resourceManager | propriété |
resourceManager:IResourceManager [lecture seule] | Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 3 |
| Versions du moteur d’exécution: | Flash Player 9, AIR 1.1 |
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():IResourceManagerFormatter | () | Constructeur |
public function Formatter()| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 3 |
| Versions du moteur d’exécution: | Flash Player 9, AIR 1.1 |
Constructeur.
format | () | méthode |
public function format(value:Object):String| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 3 |
| Versions du moteur d’exécution: | Flash Player 9, AIR 1.1 |
Formate une valeur et renvoie une chaîne contenant la nouvelle valeur formatée. Toutes les sous-classes doivent ignorer cette méthode pour implémenter la classe de formatage.
Paramètres
value:Object — Valeur à formater.
|
String — Chaîne formatée.
|
resourcesChanged | () | méthode |
protected function resourcesChanged():void| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 3 |
| Versions du moteur d’exécution: | Flash Player 9, AIR 1.1 |
Cette méthode est appelée lors de la construction d’une classe Formatter, puis chaque fois que ResourceManager envoie 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.
<?xml version="1.0" encoding="utf-8"?>
<!-- Simple example to demonstrate the Formatter class. -->
<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>
<![CDATA[
// Event handler to format the input.
private function Format():void {
// The format() method returns the formatted String,
// or an empty String if there is an error.
var formattedVal:String = numberFormatter.format(inputVal.text);
if (formattedVal.length == 0) {
// If there is an error, the Format.error property
// contains the reason.
formattedNumber.text = numberFormatter.error;
} else {
formattedNumber.text = formattedVal;
}
}
]]>
</fx:Script>
<fx:Declarations>
<mx:NumberFormatter id="numberFormatter" />
</fx:Declarations>
<s:Panel title="NumberFormatter Example"
width="75%" height="75%"
horizontalCenter="0" verticalCenter="0">
<mx:Form left="10" right="10" top="10" bottom="10">
<mx:FormItem label="Enter number - a letter is invalid:">
<s:TextInput id="inputVal" text="" width="75%"/>
</mx:FormItem>
<mx:FormItem label="Formatted number: ">
<s:TextInput id="formattedNumber" editable="false" width="75%"/>
</mx:FormItem>
<mx:FormItem>
<s:Button label="Validate and Format" click="Format();"/>
</mx:FormItem>
</mx:Form>
</s:Panel>
</s:Application>
Tue Jun 12 2018, 09:30 AM Z