CurrencyFormatter

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 die format()-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 expanded

MXML-Syntax ausblenden

The <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"
 />

Beispiele anzeigen

Verwandte API-Elemente

mx.formatters.NumberBase
mx.formatters.NumberBaseRoundType

Öffentliche Eigenschaften

Vererbte öffentliche Eigenschaften ausblenden

Vererbte öffentliche Eigenschaften anzeigen

	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

Geschützte Eigenschaften

Vererbte geschützte Eigenschaften ausblenden

Vererbte geschützte Eigenschaften anzeigen

	Eigenschaft		Definiert von
		resourceManager : IResourceManager [schreibgeschützt] Ein Verweis auf ein Objekt, welches alle lokalisierten Ressourcen der Anwendung verwaltet.	Formatter

Öffentliche Methoden

Vererbte öffentliche Methoden ausblenden

Vererbte öffentliche Methoden anzeigen

	Methode		Definiert von
		CurrencyFormatter() Konstruktor.	CurrencyFormatter
		format(value:Object):String [override] Der Wert wird als Währung formatiert.	CurrencyFormatter
		hasOwnProperty(name:String):Boolean Gibt an, ob für ein Objekt eine bestimmte Eigenschaft definiert wurde.	Object
		isPrototypeOf(theClass:Object):Boolean Gibt an, ob eine Instanz der Object-Klasse in der Prototypkette des Objekts vorhanden ist, das als Parameter angegeben wurde.	Object
		propertyIsEnumerable(name:String):Boolean Gibt an, ob die angegebene Eigenschaft vorhanden ist und durchlaufen werden kann.	Object
		setPropertyIsEnumerable(name:String, isEnum:Boolean = true):void Legt die Verfügbarkeit einer dynamischen Eigenschaft für Schleifenoperationen fest.	Object
		toLocaleString():String Gibt die Stringdarstellung dieses Objekts zurück, formatiert entsprechend den Konventionen des Gebietsschemas.	Object
		toString():String Gibt das angegebene Objekt als String zurück.	Object
		valueOf():Object Gibt den Grundwert des angegebenen Objekts zurück.	Object

Geschützte Methoden

Vererbte geschützte Methoden ausblenden

Vererbte geschützte Methoden anzeigen

	Methode		Definiert von
		resourcesChanged():void Diese Methode wird aufgerufen, wenn eine Formatierung erstellt wird, und wird erneut aufgerufen, wenn ResourceManager ein „change“-Ereignis auslöst, um anzugeben, dass sich die lokalisierten Ressourcen geändert haben.	Formatter

Eigenschaftendetails

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):void

currencySymbol

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):void

decimalSeparatorFrom

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):void

decimalSeparatorTo

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):void

precision

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):void

rounding

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):void

Verwandte API-Elemente

mx.formatters.NumberBaseRoundType

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):void

thousandsSeparatorTo

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):void

useNegativeSign

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):void

useThousandsSeparator

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):void

Konstruktordetails

()

Konstruktor

public function CurrencyFormatter()

Sprachversion:

ActionScript 3.0

Produktversion:

Flex 3

Laufzeitversionen:

Flash Player 9, AIR 1.1

Konstruktor.

Methodendetails

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.

Rückgabewerte

String — Formatierter String. Leer, wenn ein Fehler auftritt.

Beispiele Verwendung dieses Beispiels

CurrencyFormatterExample.mxml

<?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>

Rechtliche Hinweise | Onlinedatenschutzerklärung

CurrencyFormatter - AS3 Flex

Klassen x

alignSymbol

currencySymbol

decimalSeparatorFrom

decimalSeparatorTo

precision

rounding

thousandsSeparatorFrom

thousandsSeparatorTo

useNegativeSign

useThousandsSeparator

CurrencyFormatter

format