| Paket | spark.formatters |
| Klasse | public class CurrencyFormatter |
| Vererbung | CurrencyFormatter  NumberFormatterBase GlobalizationBase AdvancedStyleClient EventDispatcher Object |
| Implementiert | IFormatter |
| Sprachversion: | ActionScript 3.0 |
| Produktversion: | Flex 4.5 |
| Laufzeitversionen: | Flash Player 10.1, AIR 2.5 |
Diese Klasse ist eine Wrapper-Klasse um den flash.globalization.CurrencyFormatter. Die für das Gebietsschema spezifische Formatierung wird daher durch den flash.globalization.CurrencyFormatter bereitgestellt. Diese CurrencyFormatter-Klasse, die in MXML-Deklarationen verwendet werden kann, verwendet jedoch den locale-Stil für die angeforderte Gebietsschema-ID und hat Methoden und Eigenschaften, die bindbar sind.
Die flash.globalization.CurrencyFormatter-Klasse verwendet das zugrunde liegende Betriebssystem für die Formatierungsfunktion und für das Bereitstellen der gebietsschemaspezifischen Daten. Auf einigen Betriebssystemen werden die flash.globalization-Klassen nicht unterstützt. Auf diesen Systemen stellt diese Wrapper-Klasse Ersatzfunktionen bereit.
MXML-Syntax
MXML-Syntax anzeigen
MXML-Syntax ausblendenThe <s:CurrencyFormatter> tag inherits all of the tag
attributes of its superclass and adds the following tag attributes:
<s:CurrencyFormatter
Properties
currencyISOCode="locale and OS dependent"
currencySymbol="locale and OS dependent"
negativeCurrencyFormat="locale and OS dependent"
positiveCurrencyFormat="locale and OS dependent"
useCurrencySymbol="false"
/>
Verwandte API-Elemente
| Eigenschaft | Definiert von | ||
|---|---|---|---|
| actualLocaleIDName : String [override] [schreibgeschützt]
Der Name der Gebietsschema-ID, die von diesem Klassenobjekt verwendet wird. | CurrencyFormatter | ||
 | className : String [schreibgeschützt]
Der Name der Komponentenklasse. | AdvancedStyleClient | |
| constructor : Object
Ein Verweis auf das Klassenobjekt oder die Konstruktorfunktion für eine angegebene Objektinstanz. | Object | |
| currencyISOCode : String
Der dreistellige ISO-4217-Währungscode für das verwendete Gebietsschema (z. B. | CurrencyFormatter | ||
| currencySymbol : String
Das Währungssymbol oder der String, der für das Gebietsschema verwendet wird. | CurrencyFormatter | ||
| decimalSeparator : String
Das Dezimaltrennzeichen, das für die Formatierung oder Analyse von Zahlen mit Dezimalteil verwendet wird. | NumberFormatterBase | |
| digitsType : uint
Definiert den Satz von Ziffernzeichen, die beim Formatieren von Zahlen verwendet werden sollen. | NumberFormatterBase | |
| errorText : String
Ersetzungsstring, der bei einem Fehler von der format()-Methode zurückgegeben wird. | NumberFormatterBase | |
| fractionalDigits : int
Die Höchstzahl von Ziffern, die nach dem Dezimaltrennzeichen erscheinen können. | NumberFormatterBase | |
| groupingPattern : String
Beschreibt die Platzierung von Gruppierungstrennzeichen innerhalb des formatierten Zahlenstrings. | NumberFormatterBase | |
| groupingSeparator : String
Das Zeichen oder der String, das bzw. der als Gruppierungstrennzeichen verwendet wird. | NumberFormatterBase | |
| id : String
Die Identität der Komponente. | AdvancedStyleClient | |
| inheritingStyles : Object
Ein Objekt, das die vererbbaren Stile für diese nichtvisuelle Stilclientinstanz enthält. | AdvancedStyleClient | |
| lastOperationStatus : String [override] [schreibgeschützt]
Der Status der letzten Operation, die dieses Klassenobjekt ausgeführt hat. | NumberFormatterBase | |
| leadingZero : Boolean
Gibt an, ob in der formatierten Zahl vorne eine Null angezeigt wird, wenn es keine Ganzzahlen links des Dezimaltrennzeichens gibt. | NumberFormatterBase | |
| moduleFactory : IFlexModuleFactory
Eine Module-Factory wird als Kontext zum Suchen des Stilmanagers verwendet, der die Stile für diese nichtvisuelle Stilclientinstanz steuert. | AdvancedStyleClient | |
| negativeCurrencyFormat : uint
Ein numerischer Wert, der ein Formatierungsmuster für negative Währungsbeträge angibt. | CurrencyFormatter | ||
| negativeSymbol : String
Das Negativsymbol, das bei der Formatierung negativer Werte verwendet wird. | NumberFormatterBase | |
| nonInheritingStyles : Object
Beginn der Kette von Komponentenstilen, die keine Vererbungsstile sind. | AdvancedStyleClient | |
| positiveCurrencyFormat : uint
Ein numerischer Wert, der ein Formatierungsmuster für positive Währungsbeträge angibt. | CurrencyFormatter | ||
| styleDeclaration : CSSStyleDeclaration
Die Stildeklaration, die die von diesem Objekt deklarierten Inline-Stile enthält. | AdvancedStyleClient | |
| styleManager : IStyleManager2 [schreibgeschützt]
Gibt die von dieser Komponente verwendete StyleManager-Instanz zurück. | AdvancedStyleClient | |
| styleName : Object
Die Quelle der Stilwerte dieses Objekts. | AdvancedStyleClient | |
| styleParent : IAdvancedStyleClient
Das übergeordnete Element einer Komponente wird zur Überprüfung der untergeordneten Selektoren verwendet. | AdvancedStyleClient | |
| trailingZeros : Boolean
Gibt an, ob nachfolgende Nullen in einer formatierten Zahl angezeigt werden. | NumberFormatterBase | |
| useCurrencySymbol : Boolean
Aktiviert die Verwendung der currencySymbol-Eigenschaft bei der Formatierung von Währungsbeträgen. | CurrencyFormatter | ||
| useGrouping : Boolean
Aktiviert die Verwendung des Gruppierungstrennzeichens bei der Formatierung von Zahlen. | NumberFormatterBase | |
| Methode | Definiert von | ||
|---|---|---|---|
Konstruiert ein neues CurrencyFormatter-Objekt, um Zahlen, die Währungsbeträge darstellen, entsprechend den Konventionen eines gegebenen Gebietsschemas zu formatieren. | CurrencyFormatter | ||
| addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void
Registriert ein Ereignis-Listener-Objekt bei einem EventDispatcher-Objekt, sodass der Listener über ein Ereignis benachrichtigt wird. | EventDispatcher | |
|
Löscht eine Stileigenschaft aus dieser Komponenteninstanz. | AdvancedStyleClient | |
|
Sendet ein Ereignis in den Ereignisablauf. | EventDispatcher | |
Erstellt einen String, der einen Währungsbetrag repräsentiert, der entsprechend den aktuellen Eigenschaften dieses CurrencyFormatter-Objekts einschließlich der Eigenschaften „locale“, „useCurrencySymbol“, „currencySymbol“ oder „currencyISOCode“ formatiert ist. | CurrencyFormatter | ||
Stellt fest, ob das zurzeit angegebene Währungssymbol bei der Formatierung von Währungsbeträgen verwendet werden kann. | CurrencyFormatter | ||
[statisch]
Listet alle Gebietsschema-ID-Namen auf, die von dieser Klasse unterstützt werden. | CurrencyFormatter | ||
|
Gibt einen Array von CSSStyleDeclaration-Objekten für den Typselektor zurück, der auf diese Komponente anzuwenden ist, oder „null“, wenn keiner existiert. | AdvancedStyleClient | |
| [override]
Ruft eine Stileigenschaft ab, die an einer beliebigen Stelle in der Stilkette der Komponente festgelegt ist. | GlobalizationBase | |
|
Gibt true zurück, wenn currentCSSState ungleich null ist. | AdvancedStyleClient | |
|
Überprüft, ob das EventDispatcher-Objekt Listener für einen bestimmten Ereignistyp registriert hat. | EventDispatcher | |
|
Gibt an, ob für ein Objekt eine bestimmte Eigenschaft definiert wurde. | Object | |
|
Die initialized-Methode wird aufgerufen, wenn diese Klasse oder eine Klasse, die diese Klasse erweitert, in einer MXML-Deklaration verwendet wird. | AdvancedStyleClient | |
|
Gibt an, ob eine Instanz der Object-Klasse in der Prototypkette des Objekts vorhanden ist, das als Parameter angegeben wurde. | Object | |
|
Gibt „true“ zurück, wenn cssState mit currentCSSState übereinstimmt. | AdvancedStyleClient | |
|
Bestimmt, ob diese Instanz dem angegebenen Typ entspricht oder eine Unterklasse davon ist. | AdvancedStyleClient | |
|
Gibt Stiländerungen an die untergeordneten Elemente dieser Stilclientinstanz weiter. | AdvancedStyleClient | |
Zerlegt einen String in einen Währungsbetrag und ein Währungssymbol. | CurrencyFormatter | ||
|
Gibt an, ob die angegebene Eigenschaft vorhanden ist und durchlaufen werden kann. | Object | |
|
Legt die internen Stilcachewerte fest, sodass die getStyle()-Methode funktioniert. | AdvancedStyleClient | |
|
Registriert den EffectManager als einen der Ereignis-Listener für jedes Effekt-Ereignis. | AdvancedStyleClient | |
|
Entfernt einen Listener aus dem EventDispatcher-Objekt. | EventDispatcher | |
|
Legt die Verfügbarkeit einer dynamischen Eigenschaft für Schleifenoperationen fest. | Object | |
|
Legt eine Stileigenschaft für diese Komponenteninstanz fest. | AdvancedStyleClient | |
|
Erkennt Änderungen an Stileigenschaften. | AdvancedStyleClient | |
|
Flex ruft die stylesInitialized()-Methode auf, wenn die Stile für eine Komponente zum ersten Mal initialisiert werden. | AdvancedStyleClient | |
|
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 | |
|
Überprüft, ob bei diesem EventDispatcher-Objekt oder bei einem seiner Vorgänger ein Ereignis-Listener für einen bestimmten Ereignistyp registriert ist. | EventDispatcher | |
Stile sind entweder allgemein oder mit einem bestimmten Thema verknüpft. Allgemeine Stile können mit jedem Thema verwendet werden. Stile, die mit einem bestimmten Thema verknüpft sind, können nur verwendet werden, wenn Ihre Anwendung dieses Thema verwendet.
actualLocaleIDName | Eigenschaft |
actualLocaleIDName:String [schreibgeschützt] [override] | Sprachversion: | ActionScript 3.0 |
| Produktversion: | Flex 4.5 |
| Laufzeitversionen: | Flash Player 10.1, AIR 2.5 |
Der Name der Gebietsschema-ID, die von diesem Klassenobjekt verwendet wird. Dies ist das Gebietsschema, das verwendet wird, um auf Formatierungsdaten und Funktionen vom Betriebssystem aus zuzugreifen.
Wenn das vom locale-Stil festgelegte Gebietsschema nicht verfügbar ist, sind der Wert des actualLocaleIDName und der Wert des locale-Stils unterschiedlich. Er gibt das Ersatzgebietsschema an, das verwendet wird. Wenn für den locale-Stil LocaleID.DEFAULT festgelegt wurde, wird der Name des vom Betriebssystem des Benutzers festgelegten Gebietsschemas verwendet.
Diese Eigenschaft kann als Quelle für die Datenbindung verwendet werden. Beim Ändern dieser Eigenschaft wird das change -Ereignis ausgelöst.
Implementierung
override public function get actualLocaleIDName():StringVerwandte API-Elemente
currencyISOCode | Eigenschaft |
currencyISOCode:String| Sprachversion: | ActionScript 3.0 |
| Produktversion: | Flex 4.5 |
| Laufzeitversionen: | Flash Player 10.1, AIR 2.5 |
Der dreistellige ISO-4217-Währungscode für das verwendete Gebietsschema (z. B. USD, EUR, JPY, CNY).
Wenn für die useCurrencySymbol-Eigenschaft false angegeben wird, wird dieser Code bei der Formatierung von Währungsbeträgen mithilfe der format()-Methode zur Angabe des Währungstyps verwendet.
Diese Eigenschaft wird initialisiert, wenn der Gebietsschemastil basierend auf dem verwendeten Gebietsschema festgelegt wird. Wenn ein Ersatzgebietsschema verwendet wird, gibt diese Eigenschaft den bevorzugten Standardwährungscode für das Ersatzgebietsschema an.
Der Standardwert hängt vom Gebietsschema und Betriebssystem ab.
Diese Eigenschaft kann als Quelle für die Datenbindung verwendet werden. Beim Ändern dieser Eigenschaft wird das change -Ereignis ausgelöst.
Implementierung
public function get currencyISOCode():String public function set currencyISOCode(value:String):voidAuslöser
TypeError — wenn dieser Eigenschaft ein null-Wert zugewiesen wird.
|
Verwandte API-Elemente
currencySymbol | Eigenschaft |
currencySymbol:String| Sprachversion: | ActionScript 3.0 |
| Produktversion: | Flex 4.5 |
| Laufzeitversionen: | Flash Player 10.1, AIR 2.5 |
Das Währungssymbol oder der String, der für das Gebietsschema verwendet wird.
Diese Eigenschaft wird als Währungssymbol verwendet, wenn Währungsbeträge mit der format()-Methode formatiert werden, während der withCurrencySymbol-Parameter den Wert true hat.
Diese Eigenschaft wird initialisiert, wenn der Gebietsschemastil basierend auf dem verwendeten Gebietsschema festgelegt wird. Wenn ein Ersatzgebietsschema verwendet wird, gibt diese Eigenschaft das bevorzugte Standardwährungssymbol für das Ersatzgebietsschema an. Dieses kann sich vom Gebietsschemastil unterscheiden.
Der Standardwert hängt vom Gebietsschema und Betriebssystem ab.
Diese Eigenschaft kann als Quelle für die Datenbindung verwendet werden. Beim Ändern dieser Eigenschaft wird das change -Ereignis ausgelöst.
Implementierung
public function get currencySymbol():String public function set currencySymbol(value:String):voidAuslöser
TypeError — wenn dieser Eigenschaft ein null-Wert zugewiesen wird.
|
Verwandte API-Elemente
negativeCurrencyFormat | Eigenschaft |
negativeCurrencyFormat:uint| Sprachversion: | ActionScript 3.0 |
| Produktversion: | Flex 4.5 |
| Laufzeitversionen: | Flash Player 10.1, AIR 2.5 |
Ein numerischer Wert, der ein Formatierungsmuster für negative Währungsbeträge angibt. Dieses Muster definiert die Position des Währungssymbols und des Negativsymbols oder von Klammern in Relation zum numerischen Teil des Währungsbetrags.
Der Wert dieser Eigenschaft muss eine der in der folgenden Tabelle definierten Konstanten sein.
In der Tabelle sind die möglichen Formatierungsmuster für negative Währungsbeträge aufgeführt. Wenn ein Währungsbetrag mit der format()-Methode formatiert wird, gilt Folgendes:
- Das Symbol '¤' wird durch den Wert der
currencyISOCode- oder dercurrencySymbol-Eigenschaft ersetzt, abhängig vom Wert deswithCurrencySymbol-Parameters, der an dieformat()-Methode übergeben wird. - Das Zeichen '-' wird durch den Wert der
negativeNumberSymbol-Eigenschaft ersetzt. - Das Zeichen 'n' wird durch den Wert des Währungsbetrags ersetzt, der an die
format()-Methode übergeben wird.
| Formattyp für negative Währungsbeträge | Formatierungsmuster |
| 0 | (¤n) |
| 1 | -¤n |
| 2 | ¤-n |
| 3 | ¤n- |
| 4 | (n¤) |
| 5 | -n¤ |
| 6 | n-¤ |
| 7 | n¤- |
| 8 | -n ¤ |
| 9 | -¤ n |
| 10 | n ¤- |
| 11 | ¤ n- |
| 12 | ¤ -n |
| 13 | n- ¤ |
| 14 | (¤ n) |
| 15 | (n ¤) |
Der Standardwert hängt vom Gebietsschema und Betriebssystem ab.
Diese Eigenschaft kann als Quelle für die Datenbindung verwendet werden. Beim Ändern dieser Eigenschaft wird das change -Ereignis ausgelöst.
Implementierung
public function get negativeCurrencyFormat():uint public function set negativeCurrencyFormat(value:uint):voidAuslöser
ArgumentError — wenn der zugewiesene Wert nicht zwischen 0 und 15 liegt.
|
Verwandte API-Elemente
positiveCurrencyFormat | Eigenschaft |
positiveCurrencyFormat:uint| Sprachversion: | ActionScript 3.0 |
| Produktversion: | Flex 4.5 |
| Laufzeitversionen: | Flash Player 10.1, AIR 2.5 |
Ein numerischer Wert, der ein Formatierungsmuster für positive Währungsbeträge angibt. Dieses Format definiert die Position des Währungssymbols in Relation zum numerischen Teil des Währungsbetrags.
Der Wert dieser Eigenschaft muss eine der in der folgenden Tabelle definierten Konstanten sein.
In der Tabelle sind die möglichen Formatierungsmuster für positive Währungsbeträge aufgeführt. Wenn ein Währungsbetrag mit der format()-Methode formatiert wird, gilt Folgendes:
- Das Symbol '¤' wird durch den Wert der
currencyISOCode- oder dercurrencySymbol-Eigenschaft ersetzt, abhängig vom Wert deswithCurrencySymbol-Parameters, der an dieformat()-Methode übergeben wird. - Das Zeichen 'n' wird durch den Wert des Währungsbetrags ersetzt, der an die
format()-Methode übergeben wird.
| Formattyp für positive Währungsbeträge | Formatierungsmuster |
| 0 | ¤n |
| 1 | n¤ |
| 2 | ¤ n |
| 3 | n ¤ |
Der Standardwert hängt vom Gebietsschema und Betriebssystem ab.
Diese Eigenschaft kann als Quelle für die Datenbindung verwendet werden. Beim Ändern dieser Eigenschaft wird das change -Ereignis ausgelöst.
Implementierung
public function get positiveCurrencyFormat():uint public function set positiveCurrencyFormat(value:uint):voidAuslöser
ArgumentError — wenn der zugewiesene Wert nicht zwischen 0 und 3 liegt.
|
Verwandte API-Elemente
useCurrencySymbol | Eigenschaft |
useCurrencySymbol:Boolean| Sprachversion: | ActionScript 3.0 |
| Produktversion: | Flex 4.5 |
| Laufzeitversionen: | Flash Player 10.1, AIR 2.5 |
Aktiviert die Verwendung der currencySymbol-Eigenschaft bei der Formatierung von Währungsbeträgen.
Wenn für die useCurrencySymbol-Eigenschaft true festgelegt ist, wird der Wert der currencySymbol-Eigenschaft im durch die format-Methode zurückgegebenen String verwendet. Beispiel: $123,456,789.22
Wenn für die useCurrencySymbol-Eigenschaft false festgelegt ist, wird der Wert der currencyISOCode-Eigenschaft im durch die format-Methode zurückgegebenen String verwendet. Beispiel: USD 123,456,789.22
Der Standardwert ist false.
Diese Eigenschaft kann als Quelle für die Datenbindung verwendet werden. Beim Ändern dieser Eigenschaft wird das change -Ereignis ausgelöst.
Implementierung
public function get useCurrencySymbol():Boolean public function set useCurrencySymbol(value:Boolean):voidVerwandte API-Elemente
CurrencyFormatter | () | Konstruktor |
public function CurrencyFormatter()| Sprachversion: | ActionScript 3.0 |
| Produktversion: | Flex 4.5 |
| Laufzeitversionen: | Flash Player 10.1, AIR 2.5 |
Konstruiert ein neues CurrencyFormatter-Objekt, um Zahlen, die Währungsbeträge darstellen, entsprechend den Konventionen eines gegebenen Gebietsschemas zu formatieren.
Das Gebietsschema für diese Klasse wird vom Gebietsschema-Stil bereitgestellt. Der Gebietsschema-Stil kann auf verschiedene Arten festgelegt werden:
- Durch Verwenden der Klasse in einer MXML-Deklaration und Übernehmen des Gebietsschemas aus dem Dokument, das die Deklaration enthält. Beispiel:
<fx:Declarations>
<s:CurrencyFormatter id="cf" />
</fx:Declarations>
<fx:Declarations>
<s:CurrencyFormatter id="cf_Japanese" locale="ja-JP" />
</fx:Declarations>
setStyle()-Methode, z. B. cf.setStyle("locale", "ja-JP")
UIComponent durch Aufruf der addStyleClient()-Methode der UIComponent.
Wenn der locale-Stil nicht durch eine der oben beschriebenen Methoden festgelegt wird, wird die Instanz dieser Klasse als StyleClient der topLevelApplication hinzugefügt und übernimmt daher den locale-Stil aus dem topLevelApplication-Objekt, wenn die locale-abhängige Get-Funktion oder locale-abhängige Methode aufgerufen wird.
Die meisten Eigenschaften dieser Klasse werden automatisch basierend auf dem locale-Stil festgelegt. Wenn der locale-Stil geändert wird, werden auch alle Eigenschaften, die nicht explizit festgelegt wurden, basierend auf dem neuen Gebietsschema aktualisiert. Beachten Sie, dass das verwendete Gebietsschema von der actualLocaleIDName-Eigenschaft festgelegt wird.
Hinweis: Wenn ein Ersatzgebietsschema verwendet wird, werden die Währungseigenschaften auf die Standardwerte gesetzt, weshalb die Eigenschaften currencySymbol oder currencyISOCode möglicherweise unerwartete Werte bekommen. Deshalb empfiehlt es sich, vor dem Formatieren eines Währungsbetrags die Werte der Eigenschaften currencySymbol und currencyISOCode zu untersuchen.
Verwandte API-Elemente
format | () | Methode |
public function format(value:Object):String| Sprachversion: | ActionScript 3.0 |
| Produktversion: | Flex 4.5 |
| Laufzeitversionen: | Flash Player 10.1, AIR 2.5 |
Erstellt einen String, der einen Währungsbetrag repräsentiert, der entsprechend den aktuellen Eigenschaften dieses CurrencyFormatter-Objekts einschließlich der Eigenschaften locale, useCurrencySymbol, currencySymbol oder currencyISOCode formatiert ist.
Die useCurrencySymbol-Eigenschaft bestimmt, ob die format-Methode currencySymbol oder currencyISOCode im formatierten Währungsbetrag verwendet. Der Standardwert für useCurrencySymobl ist false. Währungsbeträge werden also standardmäßig mit currencyISOCode formatiert.
Viele Länder und Regionen verwenden dieselben Währungssymbole für verschiedene Währungen. Die Vereinigten Staaten, Australien, Neuseeland, Kanada und Mexiko verwenden zum Beispiel alle dasselbe Dollarzeichen ($) für lokale Währungswerte. Wenn sich die formatierte Währung von der lokalen Währung des Benutzers unterscheidet, ist es am besten, den ISO-Code als Währungsstring zu verwenden. Mithilfe der formattingWithCurrencySymbolIsSafe()-Methode können Sie testen, ob der ISO-Code der zu formatierenden Währung mit dem Standard-ISO-Code der Währung für das tatsächliche vom Formatter verwendete Gebietsschema übereinstimmt.
Diese Methode kann sehr große und sehr kleine Zahlen formatieren. Die Anzahl der gültigen Ziffern wird jedoch durch die vom Number-Datentyp angegebene Genauigkeit limitiert.
Wenn aufgrund eines unzulässigen Eingabewerts oder anderen Fehlers ein Fehler beim Formatieren auftritt, gibt die format()-Methode standardmäßig null zurück. Wenn die errorText-Eigenschaft jedoch ungleich null ist, wird der Wert der errorText-Eigenschaft zurückgegeben. Die lastOperationStatus-Eigenschaft wird festgelegt, um den aufgetretenen Fehler anzugeben.
Parameter
value:Object — Ein Objekt, das den numerischen Wert enthält, der als Währungs-String formatiert werden soll. Wenn das Objekt keine Number ist, wird es in eine Zahl mithilfe der Number()-Konvertierungsfunktion konvertiert.
|
String — Ein String, der den formatierten Währungswert enthält.
|
Verwandte API-Elemente
currencyISOCode
formattingWithCurrencySymbolIsSafe()
lastOperationStatus
useCurrencySymbol
spark.formatters.supportClasses.NumberFormatterBase.errorText
spark.globalization.LastOperationStatus
Beispiel ( Verwendung dieses Beispiels )
locale-Stil „fr-CA“ [Französisch (Kanada)] verwendet. Im Beispiel wird davon ausgegangen, dass das Gebietsschema vom Betriebssystem des Benutzers unterstützt wird und deshalb kein Ersatzgebietsschema verwendet werden muss. Für das Gebietsschema fr-CA ist die Standardwährung der kanadische Dollar mit dem ISO-Code CAD. Beim Formatieren einer Währung mit den Standardwerten wird deshalb CAD als Währungssymbol verwendet. Wenn die useCurrencySymbol-Eigenschaft den Wert true hat, wird die currencySymbol-Eigenschaft zur Formatierung des Währungsbetrags verwendet.
<fx:Declarations>
<s:CurrencyFormatter id="cf_use_ISOCode" locale="fr-CA" />
<s:CurrencyFormatter id="cf_use_Symbol" locale="fr-CA"
useCurrencySymbol="true" />
</fx:Declarations>
<s:VGroup>
<!-- label will use ISO code: 1,234,567.89 CAD -->
<s:Label text="{cf_use_ISOCode.format(1234567.89)}" />
<!-- label will use currency symbol: 1,234,567.89 $ -->
<s:Label text="{cf_use_Symbol.format(1234567.89)}" />
</s:VGroup>
Das zweite Beispiel zeigt eine Methode, mit der ein Währungsbetrag in kanadischen Dollar unter Verwendung des Standardgebietsschemas des Benutzers formatiert wird. Mithilfe der formattingWithCurrencySymbolIsSafe()-Methode wird der Wert der useCurrencySymbol-Eigenschaft festgelegt. Wenn das Standardgebietsschema des Benutzers Kanada ist (z. B. „fr-CA“ oder „en-CA“), wird das standardmäßige Währungssymbol für Kanada verwendet. Wenn ein Gebietsschema als Standard festgelegt wurde, wird der currencyISOCode-Wert „CAD“ im formatierten Währungsbetrag verwendet.
<fx:Declarations>
<s:CurrencyFormatter id="cf_CAD" locale="{LocaleID.DEFAULT}"
currencyISOCode="CAD"
useCurrencySymbol="{cf_CAD.formattingWithCurrencySymbolIsSafe('CAD')}"
/>
</fx:Declarations>
<fx:Script>
<![CDATA[
import flash.globalization.LocaleID;
]]>
</fx:Script>
<!-- label will use ISO code or currency symbol depending on
user's default locale -->
<s:Label text="{cf_CAD.format(1234567.89)}" />
formattingWithCurrencySymbolIsSafe | () | Methode |
public function formattingWithCurrencySymbolIsSafe(requestedISOCode:String):Boolean| Sprachversion: | ActionScript 3.0 |
| Produktversion: | Flex 4.5 |
| Laufzeitversionen: | Flash Player 10.1, AIR 2.5 |
Stellt fest, ob das zurzeit angegebene Währungssymbol bei der Formatierung von Währungsbeträgen verwendet werden kann.
In vielen Regionen und Ländern werden dieselben Währungssymbole verwendet. Mit dieser Methode lässt sich verhindern, dass ein mehrdeutiges Währungssymbol verwendet wird, oder Währungssymbole oder ISO-Codes, die wegen der Verwendung eines Ersatzgebietsschemas nicht den erwarteten entsprechen.
Diese Methode wird häufig eingesetzt, um zu bestimmen, ob ein lokales Währungssymbol angezeigt werden soll (wenn der Betrag in der Standardwährung des Benutzers formatiert wird) oder ein genauerer ISO-Code (wenn der Betrag in einer Währung formatiert wird, die nicht dem Standard des Benutzers entspricht).
Diese Methode vergleicht den requestedISOCode-Parameter mit dem standardmäßigen currencyISOCode des tatsächlichen Gebietsschemas. Sie gibt true zurück, wenn die Strings übereinstimmen, false, wenn dies nicht der Fall ist. Stimmen die Strings überein, führt die Verwendung der format()-Methode, wobei die useCurrencySymbol-Eigenschaft den Wert true hat, zu einem formatierten Währungswertstring mit einem Währungssymbol für das Gebietsschema. Wenn diese Methode den Wert false zurückgibt, kann die Verwendung der format()-Methode mit dem Wert true für die useCurrencySymbol-Eigenschaft zur Verwendung eines mehrdeutigen oder falschen Währungssymbols führen.
Parameter
requestedISOCode:String — Ein dreistelliger Währungscode gemäß ISO 4217 (zum Beispiel USD für US-Dollar, EUR für Euro). Er muss drei Großbuchstaben von A bis Z enthalten.
|
Boolean — true, wenn der standardmäßige currencyISOCode für das dem actualLocaleIDName entsprechende Gebietsschema mit dem requestedISOCode-Parameter übereinstimmt; andernfalls false.
|
Auslöser
TypeError — wenn der requestedISOCode-Parameter den Wert null hat
|
Verwandte API-Elemente
getAvailableLocaleIDNames | () | Methode |
public static function getAvailableLocaleIDNames():Vector.<String>| Sprachversion: | ActionScript 3.0 |
| Produktversion: | Flex 4.5 |
| Laufzeitversionen: | Flash Player 10.1, AIR 2.5 |
Listet alle Gebietsschema-ID-Namen auf, die von dieser Klasse unterstützt werden. Dies ist eine Liste von Gebietsschemas, die vom Betriebssystem unterstützt werden. Dies ist keine Liste von Gebietsschemas, für die der ResourceManager Ressourcen hat.
RückgabewerteVector.<String> — Ein Vektor von Strings, der alle von dieser Klasse und diesem Betriebssystem unterstützten Gebietsschema-ID-Namen enthält.
|
parse | () | Methode |
public function parse(inputString:String):CurrencyParseResult| Sprachversion: | ActionScript 3.0 |
| Produktversion: | Flex 4.5 |
| Laufzeitversionen: | Flash Player 10.1, AIR 2.5 |
Zerlegt einen String in einen Währungsbetrag und ein Währungssymbol.
Der Analysealgorithmus verwendet den Wert der decimalSeparator-Eigenschaft, um den integralen und den gebrochenen Teil der Zahl zu bestimmen. Er verwendet die Werte der negativeCurrencyFormat- und positiveCurrencyFormat-Eigenschaften, um die Position des Währungssymbols oder -strings in Relation zum Währungsbetrag zu ermitteln. Bei negativen Beträgen bestimmt der Wert der negativeCurrencyFormat-Eigenschaft die Position des Negativsymbols und ob Klammern verwendet werden.
Wenn die Reihenfolge des Währungssymbols, des Minuszeichens und der Zahl im Eingabestring nicht mit dem von den Eigenschaften negativeCurrencyFormat und positiveCurrencyFormat definierten Musters übereinstimmt, gilt Folgendes:
- Die
value-Eigenschaft des zurückgegebenenCurrencyParseResult-Objekts wird aufNaNgesetzt. - Die
currencyString-Eigenschaft des zurückgegebenen CurrencyParseResult-Objekts wird aufnullgesetzt. - Für die
lastOperationStatus-Eigenschaft wirdLastOperationStatus.PARSE_ERRORfestgelegt, um anzuzeigen, dass die Analyse fehlgeschlagen ist.
Der Eingabestring kann Leerzeichen enthalten; diese werden bei der Analyse ignoriert.
Die Analyse kann erfolgreich sein, auch wenn kein Währungssymbol vorhanden ist. Der Teil des Strings, der dem Währungssymbol entspricht, wird nicht validiert. Wenn es kein Währungssymbol bzw. keinen Währungsstring gibt, wird die currencyString-Eigenschaft des zurückgegebenen CurrencyParseResult-Objekts auf einen leeren String gesetzt.
Parameter
inputString:String — Der zu analysierende Eingabestring.
|
CurrencyParseResult — Ein CurrencyParseResult-Objekt, das den numerischen Wert und das Währungssymbol bzw. den Währungsstring enthält.
|
Auslöser
TypeError — wenn der inputString-Parameter den Wert null hat
|
Verwandte API-Elemente
<?xml version="1.0" encoding="utf-8"?>
<!-- Sample program for spark.formatters.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:Declarations>
<s:CurrencyFormatter id="currencyFormatter"/>
</fx:Declarations>
<fx:Script>
<![CDATA[
import flash.globalization.CurrencyParseResult;
private function localeChange():void
{
// Sets the locale style on the document UI component.
// The formatter will inherit this style.
setStyle('locale', inputLocaleIDName.text);
inputCurrencyChange();
}
private function inputCurrencyChange():void
{
const cpr:CurrencyParseResult
= currencyFormatter.parse(inputCurrency.text);
parsedResult.text = "Currency String: [" + cpr.currencyString
+ "], Amount: [" + cpr.value.toString() + "]";
}
]]>
</fx:Script>
<mx:Form>
<mx:FormItem label="Input Locale ID Name">
<mx:HBox>
<s:TextInput id="inputLocaleIDName"/>
<s:Button click="localeChange()" label="Apply"/>
</mx:HBox>
<mx:Text text="Example: 'en-US', 'fr-FR', 'ja-JP', 'ar-SA'"/>
</mx:FormItem>
<mx:FormItem label="Input Currency Amount">
<s:TextInput id="inputCurrency" change="inputCurrencyChange()"/>
<mx:Text text="Example: {currencyFormatter.format(123456789.123)}"/>
</mx:FormItem>
<mx:FormItem label="Actual Locale ID Name">
<mx:Text text="{currencyFormatter.actualLocaleIDName}"/>
</mx:FormItem>
<mx:FormItem label="Parsed Result">
<mx:Text id="parsedResult"/>
</mx:FormItem>
</mx:Form>
</s:Application>
<?xml version="1.0" encoding="utf-8"?>
<!-- Simple example to demonstrate the Spark 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:Declarations>
<s:CurrencyFormatter id="currencyFormatter"/>
</fx:Declarations>
<fx:Script>
<![CDATA[
[Bindable]
private var currencyAmount:Number = 123456.789;
]]>
</fx:Script>
<mx:Form>
<mx:FormItem label="Input Locale ID Name">
<mx:HBox>
<s:TextInput id="inputLocaleIDName"/>
<!-- Upon button click, sets the locale style on the document
UI component. The formatter will inherit this style. -->
<s:Button click="setStyle('locale', inputLocaleIDName.text);"
label="Apply"/>
</mx:HBox>
<mx:Text text="Example: 'en-US', 'fr-FR', 'ja-JP', 'ar-SA'"/>
</mx:FormItem>
<mx:FormItem label="Use Currency Symbol">
<s:CheckBox id="useSymbol"
click="currencyFormatter.useCurrencySymbol = useSymbol.selected"/>
</mx:FormItem>
<mx:FormItem label="Actual Locale ID Name">
<s:Label text="{currencyFormatter.actualLocaleIDName}"/>
</mx:FormItem>
<mx:FormItem label="Formatted Result">
<s:Label text="{currencyFormatter.format(currencyAmount)}"/>
</mx:FormItem>
</mx:Form>
</s:Application>
Tue Jun 12 2018, 10:04 AM Z