| Paket | mx.formatters |
| Klasse | public class CurrencyFormatter |
| Vererbung | CurrencyFormatter  Formatter Object |
| Sprachversion: | ActionScript 3.0 |
| Produktversion: | Flex 3 |
| Laufzeitversionen: | Flash Player 9, AIR 1.1 |
 | Beginnend mit Flex 4.5 empfiehlt Adobe die Verwendung der Klasse spark.formatters.CurrencyFormatter als Alternative zu dieser Klasse. |
Die CurrencyFormatter-Klasse formatiert eine gültige Zahl als einen Währungswert. Es wird die Rundung und Genauigkeit der Dezimalstelle, das Tausender-Trennzeichen und das Minuszeichen angepasst. Es wird ebenfalls ein Währungssymbol hinzugefügt. Das Währungssymbol fügen Sie entweder links oder rechts vom Wert mit der Eigenschaft
alignSymbol hinzu. Das Währungssymbol kann mehrere Zeichen enthalten, einschließlich Leerstellen.
Wenn ein Fehler aufgetreten ist, wird ein leerer String zurückgegeben und ein den Fehler beschreibender String wird in der Eigenschaft error gespeichert. Die Eigenschaft error kann einen der folgenden Werte aufweisen:
-
"Invalid value"bedeutet, ein numerischer Wert wird an dieformat()-Methode übergeben. Der Wert sollte eine gültige Zahl im Format einer Zahl oder eines Strings sein. -
"Invalid format"bedeutet, dass einer der Parameter eine nicht verwendbare Einstellung enthält.
MXML-Syntax anzeigen
MXML-Syntax ausblendenThe <mx:CurrencyFormatter> tag
inherits all of the tag attributes of its superclass,
and adds the following tag attributes:
<mx:CurrencyFormatter
alignSymbol="left|right"
currencySymbol="$"
decimalSeparatorFrom="."
decimalSeparatorTo="."
precision="-1"
rounding="none|up|down|nearest"
thousandsSeparatorFrom=","
thousandsSeparatorTo=","
useNegativeSign="true|false"
useThousandsSeparator="true|false"
/>
Verwandte API-Elemente
| Eigenschaft | Definiert von | ||
|---|---|---|---|
| alignSymbol : String
Richtet das Währungssymbol an der linken oder rechten Seite der formatierten Zahl aus. | CurrencyFormatter | ||
 | constructor : Object
Ein Verweis auf das Klassenobjekt oder die Konstruktorfunktion für eine angegebene Objektinstanz. | Object | |
| currencySymbol : String
Das als Währungssymbol für eine formatierte Zahl zu verwendende Zeichen. | CurrencyFormatter | ||
| decimalSeparatorFrom : String
Das zu verwendende Dezimaltrennzeichen beim Parsing eines Eingabestrings. | CurrencyFormatter | ||
| decimalSeparatorTo : String
Das zu verwendende Dezimaltrennzeichen bei der Ausgabe formatierter Dezimalzahlen. | CurrencyFormatter | ||
| error : String
Beschreibung, die von der Formatierung gespeichert wird, wenn ein Fehler auftritt. | Formatter | |
| precision : Object
Anzahl der einzuschließenden Dezimalstellen im Ausgabestring. | CurrencyFormatter | ||
| rounding : String
Die Art für die Rundung der Zahl. | CurrencyFormatter | ||
| thousandsSeparatorFrom : String
Das als Tausender-Trennzeichen im Eingabestring zu verwendende Zeichen. | CurrencyFormatter | ||
| thousandsSeparatorTo : String
Das als Tausender-Trennzeichen im Ausgabestring zu verwendende Zeichen. | CurrencyFormatter | ||
| useNegativeSign : Object
Falls „true“, wird eine negative Zahl formatiert, indem ein Minuszeichen („-“) vorangestellt wird. | CurrencyFormatter | ||
| useThousandsSeparator : Object
Falls „true“ wird die Zahl in Tausender-Inkremente aufgeteilt, indem ein Trennzeichen verwendet wird. | CurrencyFormatter | ||
| Methode | Definiert von | ||
|---|---|---|---|
Konstruktor. | CurrencyFormatter | ||
[override]
Der Wert wird als Währung formatiert. | CurrencyFormatter | ||
|
Gibt an, ob für ein Objekt eine bestimmte Eigenschaft definiert wurde. | Object | |
|
Gibt an, ob eine Instanz der Object-Klasse in der Prototypkette des Objekts vorhanden ist, das als Parameter angegeben wurde. | Object | |
|
Gibt an, ob die angegebene Eigenschaft vorhanden ist und durchlaufen werden kann. | Object | |
|
Legt die Verfügbarkeit einer dynamischen Eigenschaft für Schleifenoperationen fest. | Object | |
|
Gibt die Stringdarstellung dieses Objekts zurück, formatiert entsprechend den Konventionen des Gebietsschemas. | Object | |
|
Gibt das angegebene Objekt als String zurück. | Object | |
|
Gibt den Grundwert des angegebenen Objekts zurück. | Object | |
alignSymbol | Eigenschaft |
alignSymbol:String| Sprachversion: | ActionScript 3.0 |
| Produktversion: | Flex 3 |
| Laufzeitversionen: | Flash Player 9, AIR 1.1 |
Richtet das Währungssymbol an der linken oder rechten Seite der formatierten Zahl aus. Zulässige Werte sind "left" und "right".
Der Standardwert ist "left".
Implementierung
public function get alignSymbol():String public function set alignSymbol(value:String):voidcurrencySymbol | Eigenschaft |
currencySymbol:String| Sprachversion: | ActionScript 3.0 |
| Produktversion: | Flex 3 |
| Laufzeitversionen: | Flash Player 9, AIR 1.1 |
Das als Währungssymbol für eine formatierte Zahl zu verwendende Zeichen. Sie können mindestens ein Zeichen zur Darstellung des Währungssymbols verwenden, beispielsweise „$“ oder „YEN“. Außerdem können Sie Leerstellen zwischen dem Währungszeichen und der formatierten Zahl einfügen. Wenn die Zahl ein negativer Wert ist, erscheint das Währungssymbol zwischen der Zahl und dem Minuszeichen oder der Klammer.
Der Standardwert ist "$".
Implementierung
public function get currencySymbol():String public function set currencySymbol(value:String):voiddecimalSeparatorFrom | Eigenschaft |
decimalSeparatorFrom:String| Sprachversion: | ActionScript 3.0 |
| Produktversion: | Flex 3 |
| Laufzeitversionen: | Flash Player 9, AIR 1.1 |
Das zu verwendende Dezimaltrennzeichen beim Parsing eines Eingabestrings.
Der Standardwert ist ".".
Implementierung
public function get decimalSeparatorFrom():String public function set decimalSeparatorFrom(value:String):voiddecimalSeparatorTo | Eigenschaft |
decimalSeparatorTo:String| Sprachversion: | ActionScript 3.0 |
| Produktversion: | Flex 3 |
| Laufzeitversionen: | Flash Player 9, AIR 1.1 |
Das zu verwendende Dezimaltrennzeichen bei der Ausgabe formatierter Dezimalzahlen.
Der Standardwert ist ".".
Implementierung
public function get decimalSeparatorTo():String public function set decimalSeparatorTo(value:String):voidprecision | Eigenschaft |
precision:Object| Sprachversion: | ActionScript 3.0 |
| Produktversion: | Flex 3 |
| Laufzeitversionen: | Flash Player 9, AIR 1.1 |
Anzahl der einzuschließenden Dezimalstellen im Ausgabestring. Sie können die Genauigkeit deaktivieren, indem Sie sie auf -1 setzen. Ein Wert von -1 bedeutet, dass die Genauigkeit nicht geändert werden soll. Wenn beispielsweise der Eingabewert 1.453 lautet und für rounding die Einstellung NumberBaseRoundType.NONE verwendet wird, wird 1.453 zurückgegeben. Wenn für precision die Einstellung -1 und eine bestimmte Rundung verwendet wird, wird ein Wert basierend auf diesem Rundungstyp zurückgegeben.
Der Standardwert ist -1.
Implementierung
public function get precision():Object public function set precision(value:Object):voidrounding | Eigenschaft |
rounding:String| Sprachversion: | ActionScript 3.0 |
| Produktversion: | Flex 3 |
| Laufzeitversionen: | Flash Player 9, AIR 1.1 |
Die Art für die Rundung der Zahl. In ActionScript kann der Wert NumberBaseRoundType.NONE, NumberBaseRoundType.UP, NumberBaseRoundType.DOWN oder NumberBaseRoundType.NEAREST betragen. In MXML kann der Wert "none", "up", "down" oder "nearest" betragen.
Der Standardwert ist NumberBaseRoundType.NONE.
Implementierung
public function get rounding():String public function set rounding(value:String):voidVerwandte API-Elemente
thousandsSeparatorFrom | Eigenschaft |
thousandsSeparatorFrom:String| Sprachversion: | ActionScript 3.0 |
| Produktversion: | Flex 3 |
| Laufzeitversionen: | Flash Player 9, AIR 1.1 |
Das als Tausender-Trennzeichen im Eingabestring zu verwendende Zeichen.
Der Standardwert ist ",".
Implementierung
public function get thousandsSeparatorFrom():String public function set thousandsSeparatorFrom(value:String):voidthousandsSeparatorTo | Eigenschaft |
thousandsSeparatorTo:String| Sprachversion: | ActionScript 3.0 |
| Produktversion: | Flex 3 |
| Laufzeitversionen: | Flash Player 9, AIR 1.1 |
Das als Tausender-Trennzeichen im Ausgabestring zu verwendende Zeichen.
Der Standardwert ist ",".
Implementierung
public function get thousandsSeparatorTo():String public function set thousandsSeparatorTo(value:String):voiduseNegativeSign | Eigenschaft |
useNegativeSign:Object| Sprachversion: | ActionScript 3.0 |
| Produktversion: | Flex 3 |
| Laufzeitversionen: | Flash Player 9, AIR 1.1 |
Falls true, wird eine negative Zahl formatiert, indem ein Minuszeichen („-“) vorangestellt wird. Falls false, wird die Zahl von Klammern umgeben formatiert, beispielsweise (400).
Der Standardwert ist true.
Implementierung
public function get useNegativeSign():Object public function set useNegativeSign(value:Object):voiduseThousandsSeparator | Eigenschaft |
useThousandsSeparator:Object| Sprachversion: | ActionScript 3.0 |
| Produktversion: | Flex 3 |
| Laufzeitversionen: | Flash Player 9, AIR 1.1 |
Falls true wird die Zahl in Tausender-Inkremente aufgeteilt, indem ein Trennzeichen verwendet wird.
Der Standardwert ist true.
Implementierung
public function get useThousandsSeparator():Object public function set useThousandsSeparator(value:Object):voidCurrencyFormatter | () | Konstruktor |
public function CurrencyFormatter()| Sprachversion: | ActionScript 3.0 |
| Produktversion: | Flex 3 |
| Laufzeitversionen: | Flash Player 9, AIR 1.1 |
Konstruktor.
format | () | Methode |
override public function format(value:Object):String| Sprachversion: | ActionScript 3.0 |
| Produktversion: | Flex 3 |
| Laufzeitversionen: | Flash Player 9, AIR 1.1 |
Formatiert value als Währung. Wenn value nicht formatiert werden kann, wird ein leerer String zurückgegeben und eine Beschreibung des Fehlers in der Eigenschaft error geschrieben.
Parameter
value:Object — Der zu formatierende Wert.
|
String — Formatierter String. Leer, wenn ein Fehler auftritt.
|
<?xml version="1.0" encoding="utf-8"?>
<!-- Simple example to demonstrate the CurrencyFormatter. -->
<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[
import mx.events.ValidationResultEvent;
private var vResult:ValidationResultEvent;
// Event handler to validate and format input.
private function Format():void {
vResult = numVal.validate();
if (vResult.type==ValidationResultEvent.VALID) {
var temp:Number = Number(priceUS.text);
formattedUSPrice.text = usdFormatter.format(temp);
} else {
formattedUSPrice.text = "";
}
}
]]>
</fx:Script>
<fx:Declarations>
<mx:CurrencyFormatter id="usdFormatter" precision="2"
currencySymbol="$" decimalSeparatorFrom="."
decimalSeparatorTo="." useNegativeSign="true"
useThousandsSeparator="true" alignSymbol="left"/>
<mx:NumberValidator id="numVal" source="{priceUS}" property="text"
allowNegative="true" domain="real"/>
</fx:Declarations>
<s:Panel title="CurrencyFormatter Example"
width="75%" height="75%"
horizontalCenter="0" verticalCenter="0">
<mx:Form left="10" right="10" top="10" bottom="10">
<mx:FormItem label="Enter U.S. dollar amount:">
<s:TextInput id="priceUS" text="" width="50%"/>
</mx:FormItem>
<mx:FormItem label="Formatted amount: ">
<s:TextInput id="formattedUSPrice" text="" width="50%" editable="false"/>
</mx:FormItem>
<mx:FormItem>
<s:Button label="Validate and Format" click="Format();"/>
</mx:FormItem>
</mx:Form>
</s:Panel>
</s:Application>
Tue Jun 12 2018, 10:04 AM Z