| Paket | spark.formatters |
| Klasse | public class NumberFormatter |
| Vererbung | NumberFormatter  NumberFormatterBase GlobalizationBase AdvancedStyleClient EventDispatcher Object |
| Implementiert | IFormatter |
| Sprachversion: | ActionScript 3.0 |
| Produktversion: | Flex 4.5 |
| Laufzeitversionen: | Flash Player 10.1, AIR 2.5 |
int-, uint- und Number-Objekte formatieren.
Diese Klasse ist eine Wrapper-Klasse um die flash.globalization.NumberFormatter-Klasse. Die für das Gebietsschema spezifische Formatierung wird daher durch den flash.globalization.NumberFormatter bereitgestellt. Diese NumberFormatter-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.NumberFormatter-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:NumberFormatter> tag inherits all of the tag
attributes of its superclass and adds the following tag attributes:
<s:NumberFormatter
Properties
negativeNumberFormat="locale and OS dependent"
/>
Verwandte API-Elemente
| Eigenschaft | Definiert von | ||
|---|---|---|---|
| actualLocaleIDName : String [override] [schreibgeschützt]
Der Name der Gebietsschema-ID, die von diesem Klassenobjekt verwendet wird. | NumberFormatter | ||
 | 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 | |
| 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 | |
| negativeNumberFormat : uint
Ein numerischer Wert, der ein Formatierungsmuster für negative Zahlen angibt. | NumberFormatter | ||
| 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 | |
| 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 | |
| useGrouping : Boolean
Aktiviert die Verwendung des Gruppierungstrennzeichens bei der Formatierung von Zahlen. | NumberFormatterBase | |
| Methode | Definiert von | ||
|---|---|---|---|
Konstruiert ein neues NumberFormatter-Objekt, um Zahlen entsprechend den Konventionen eines gegebenen Gebietsschemas zu formatieren. | NumberFormatter | ||
| 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 | |
Formatiert eine Zahl. | NumberFormatter | ||
[statisch]
Listet alle Gebietsschema-ID-Namen auf, die von dieser Klasse unterstützt werden. | NumberFormatter | ||
|
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 | |
Analysiert einen String und gibt ein NumberParseResult-Objekt zurück, das die analysierten Elemente enthält. | NumberFormatter | ||
Analysiert einen String, der nur Ziffern und optionale Leerraumzeichen enthält und gibt eine Zahl zurück. | NumberFormatter | ||
|
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
NumberFormatter()
negativeNumberFormat | Eigenschaft |
negativeNumberFormat: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 Zahlen angibt. Dieses Muster definiert die Position des Negativsymbols oder von Klammern in Relation zum numerischen Teil der formatierten Zahl.
In der folgenden Tabelle sind die möglichen Formate für negative Zahlen aufgeführt. Wenn eine negative Zahl formatiert wird, wird das Minuszeichen im Format durch den Wert der negativeSymbol-Eigenschaft ersetzt und das Zeichen 'n' wird durch den formatierten numerischen Wert ersetzt.
| Formattyp für negative Zahlen | Format |
| 0 | (n) |
| 1 | -n |
| 2 | - n |
| 3 | n- |
| 4 | 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 negativeNumberFormat():uint public function set negativeNumberFormat(value:uint):voidAuslöser
ArgumentError — wenn der zugewiesene Wert keine Zahl zwischen 0 und 4 ist.
|
Verwandte API-Elemente
NumberFormatter | () | Konstruktor |
public function NumberFormatter()| Sprachversion: | ActionScript 3.0 |
| Produktversion: | Flex 4.5 |
| Laufzeitversionen: | Flash Player 10.1, AIR 2.5 |
Konstruiert ein neues NumberFormatter-Objekt, um Zahlen entsprechend den Konventionen eines gegebenen Gebietsschemas zu formatieren.
Das Gebietsschema für diese Klasse wird vom Gebietsschemastil bereitgestellt. Der Gebietsschemastil kann auf verschiedene Weisen 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:NumberFormatter id="nf" /> </fx:Declarations> -
Durch Verwenden einer MXML-Deklaration und Festlegen des Gebietsschemawerts in der Liste mit Zuweisungen. Beispiel:
<fx:Declarations> <s:NumberFormatter id="nf_French_France" locale="fr_FR" /> </fx:Declarations> -
Aufrufen der setStyle-Methode. Beispiel:
nf.setStyle("locale", "fr-FR") -
Übernehmen des Stils aus einer
UIComponentdurch Aufruf deraddStyleClient()-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 Gebietsschemastil festgelegt. Wenn der Gebietsschemastil 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.
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 |
Formatiert eine Zahl.
Diese Funktion formatiert die Zahl anhand der Eigenschaftenwerte des Formatters. Wenn die Eigenschaften nach dem Festlegen des locale-Stils nicht geändert werden, werden die Zahlen so formatiert, wie es die gebietsschemaspezifischen Konventionen vorsehen, die vom Betriebssystem für das von der actualLocaleIDName-Eigenschaft angegebene Gebietsschema bereitgestellt werden. Zur Anpassung des Formats können die Eigenschaften geändert werden, um bestimmte Aspekte der Zahlenformatierung zu steuern.
Mit dieser Funktion können sehr große und sehr kleine Zahlen formatiert werden. Die Anzahl der gültigen Ziffern wird jedoch durch die vom Number-Objekt angegebene Genauigkeit limitiert. Die wissenschaftliche Schreibweise wird nicht unterstützt.
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 einen zu formatierenden Zahlenwert enthält. Wenn das Objekt keine Number ist, wird es mithilfe der Number()-Konvertierungsfunktion in eine Zahl konvertiert.
|
String — Ein formatierter Zahlenstring.
|
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):NumberParseResult| Sprachversion: | ActionScript 3.0 |
| Produktversion: | Flex 4.5 |
| Laufzeitversionen: | Flash Player 10.1, AIR 2.5 |
Analysiert einen String und gibt ein NumberParseResult-Objekt zurück, das die analysierten Elemente enthält.
Das NumberParseResult-Objekt enthält den Wert der ersten Zahl, die im Eingabestring gefunden wird, den Startindex für die Zahl in diesem String und den Index des ersten Zeichens nach der Zahl im String.
Wenn der String keine Zahl enthält, wird die value-Eigenschaft von NumberParseResult auf NaN gesetzt und die Eigenschaften startIndex und endIndex werden auf den Hexadezimalwert 0x7fffffff gesetzt.
Diese Funktion verwendet den Wert der decimalSeparator-Eigenschaft, um den Teil der Zahl zu ermitteln, der gebrochene Ziffern enthält, die groupingSeparator-Eigenschaft, um zu ermitteln, welche Zeichen in den Ziffern einer Zahl zulässig sind, und die negativeNumberFormat-Eigenschaft, um zu steuern, wie negative Werte dargestellt werden.
In der folgenden Tabelle sind die Ergebnisse von analysierten Strings für die verschiedenen Werte von NegativeNumberFormat aufgeführt:
| NegativeNumberFormat | Input String | Ergebnis |
| (n) | "(123)" oder "( 123 )" | "-123" |
| -n | "-123" oder "- 123" | "-123" |
| - n | "-123" oder "- 123" | "-123" |
| n- | "123-" oder "123 -" | "-123" |
| n - | "123-" oder "123 -" | "-123" |
Zwischen den Zahlen und dem Minuszeichen oder den Klammern ist ein einzelner Leerraum zulässig. Ein Leerraumzeichen ist ein Zeichen, das eine Space Separator(Zs)-Eigenschaft in der Unicode-Zeichendatenbank hat. Weitere Informationen finden Sie unter http://www.unicode.org/ucd/.
Andere Eigenschaften werden beim Ermitteln einer gültigen Nummer ignoriert. Speziell der Wert der digitsType-Eigenschaft wird ignoriert und die Ziffern können aus einem der Ziffernsätze stammen, die in der NationalDigitsType-Klasse aufgezählt werden. Die Werte der Eigenschaften groupingPattern und useGrouping haben keinen Einfluss auf die Analyse der Zahl.
Wenn vor oder hinter einer Zahl im String ein Pluszeichen + steht, wird das Pluszeichen als Zeichen gewertet, das kein Teil der Zahl ist.
Diese Funktion analysiert keine Strings, die Zahlen in wissenschaftlicher Schreibweise enthalten (z. B. 1.23e40).
Parameter
inputString:String — Der zu analysierende Eingabestring.
|
NumberParseResult — Ein NumberParseResult-Objekt, das den numerischen Wert und die Indizes für den Start- und Endabschnitt des Strings enthält, der die Zahl enthält.
|
Auslöser
TypeError — wenn der inputString-Parameter den Wert null hat
|
Verwandte API-Elemente
Beispiel ( Verwendung dieses Beispiels )
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"
parseNumber | () | Methode |
public function parseNumber(parseString:String):Number| Sprachversion: | ActionScript 3.0 |
| Produktversion: | Flex 4.5 |
| Laufzeitversionen: | Flash Player 10.1, AIR 2.5 |
Analysiert einen String, der nur Ziffern und optionale Leerraumzeichen enthält und gibt eine Zahl zurück. Wenn der String nicht mit einer Zahl beginnt oder andere Zeichen als Leerraum enthält, die nicht Teil der Zahl sind, gibt diese Methode NaN zurück. Leerraum vor oder nach den numerischen Zeichen wird ignoriert.
Wenn vor oder hinter der numerischen Ziffer ein Pluszeichen „+“ steht, wird es als Nicht-Leerraumzeichen behandelt. Der Rückgabewert ist NaN.
Weitere Informationen zur Analyse von Zahlen und der Definition von gültigen Zahlen finden Sie in der Beschreibung der parse-Funktion.
Parameter
parseString:String — Der zu analysierende Eingabestring.
|
Number — Ein Number-Objekt, das den numerischen Wert enthält.
|
Auslöser
TypeError — wenn der parseString den Wert null hat.
|
Verwandte API-Elemente
<?xml version="1.0" encoding="utf-8"?>
<!-- Sample program for spark.formatters.NumberFormatter -->
<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:NumberFormatter id="numberFormatter"/>
</fx:Declarations>
<fx:Script>
<![CDATA[
[Bindable]
private var number:Number = 123456789.123456789;
]]>
</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 Grouping">
<mx:CheckBox id="useGrouping"
change="numberFormatter.useGrouping= useGrouping.selected"/>
</mx:FormItem>
<mx:FormItem label="Fractional Digits">
<mx:TextInput id="fractionalDigits"
change="numberFormatter.fractionalDigits = Number(fractionalDigits.text)"/>
</mx:FormItem>
<mx:FormItem label="Actual Locale ID Name">
<mx:Text text="{numberFormatter.actualLocaleIDName}"/>
</mx:FormItem>
<mx:FormItem label="Formatted Result">
<mx:Text text="{numberFormatter.format(number)}"/>
</mx:FormItem>
</mx:Form>
</s:Application>
<?xml version="1.0" encoding="utf-8"?>
<!-- Sample program for spark.formatters.NumberFormatter -->
<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:NumberFormatter id="numberFormatter"/>
</fx:Declarations>
<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="Input Number">
<s:TextInput id="inputNumber"/>
<mx:Text text="Example: {numberFormatter.format(123456789.123)}"/>
</mx:FormItem>
<mx:FormItem label="Actual Locale ID Name">
<mx:Text text="{numberFormatter.actualLocaleIDName}"/>
</mx:FormItem>
<mx:FormItem label="Parsed Result">
<mx:Text
text="{numberFormatter.parseNumber(inputNumber.text).toString()}"/>
</mx:FormItem>
</mx:Form>
</s:Application>
Tue Jun 12 2018, 10:04 AM Z