Paket | spark.formatters.supportClasses |
Klasse | public class NumberFormatterBase |
Vererbung | NumberFormatterBase GlobalizationBase AdvancedStyleClient EventDispatcher Object |
Unterklassen | CurrencyFormatter, NumberFormatter |
Sprachversion: | ActionScript 3.0 |
Produktversion: | Flex 4.5 |
Laufzeitversionen: | Flash Player 10, AIR 2.5 |
The <s:NumberFormatterBase>
tag inherits all of the tag
attributes of its superclass and adds the following tag attributes:
<s:NumberFormatterBase Properties decimalSeparator="locale and OS dependent" digitsType="locale and OS dependent" errorText="null" fractionalDigits="locale and OS dependent" groupingPattern="locale and OS dependent" groupingSeparator="locale and OS dependent" leadingZero="locale and OS dependent" negativeSymbol="locale and OS dependent" trailingZeros="locale and OS dependent" useGrouping="locale and OS dependent" />
Verwandte API-Elemente
Eigenschaft | Definiert von | ||
---|---|---|---|
actualLocaleIDName : String [schreibgeschützt]
Der Name der Gebietsschema-ID, die von diesem Klassenobjekt verwendet wird. | GlobalizationBase | ||
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 | ||
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 | ||
---|---|---|---|
Konstruktor. | NumberFormatterBase | ||
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 | ||
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 | ||
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.
decimalSeparator | Eigenschaft |
decimalSeparator:String
Sprachversion: | ActionScript 3.0 |
Produktversion: | Flex 4.5 |
Laufzeitversionen: | Flash Player 10, AIR 2.5 |
Das Dezimaltrennzeichen, das für die Formatierung oder Analyse von Zahlen mit Dezimalteil verwendet wird.
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 decimalSeparator():String
public function set decimalSeparator(value:String):void
Auslöser
TypeError — wenn dieser Eigenschaft ein null-Wert zugewiesen wird.
|
Verwandte API-Elemente
digitsType | Eigenschaft |
digitsType:uint
Sprachversion: | ActionScript 3.0 |
Produktversion: | Flex 4.5 |
Laufzeitversionen: | Flash Player 10, AIR 2.5 |
Definiert den Satz von Ziffernzeichen, die beim Formatieren von Zahlen verwendet werden sollen.
Verschiedene Sprachen und Regionen verwenden unterschiedliche Zeichengruppen, um die Ziffern 0 bis 9 darzustellen. Diese Eigenschaft definiert die verwendete Zifferngruppe.
Der Wert dieser Eigenschaft repräsentiert den Unicode-Wert für die Ziffer Null einer dezimalen Zifferngruppe. Die gültigen Werte für diese Eigenschaft werden in der NationalDigitsType
-Klasse definiert.
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 digitsType():uint
public function set digitsType(value:uint):void
Verwandte API-Elemente
errorText | Eigenschaft |
errorText:String
Sprachversion: | ActionScript 3.0 |
Produktversion: | Flex 4.5 |
Laufzeitversionen: | Flash Player 10, AIR 2.5 |
Ersetzungsstring, der bei einem Fehler von der format()
-Methode zurückgegeben wird.
Wenn für errorText
ein anderer Wert als „null“ festgelegt ist und während der Formatierung einer Zahl oder eines Währungsbetrags ein Fehler auftritt, gibt die format-Methode den dieser Eigenschaft zugewiesenen String zurück.
var nf:NumberFormatter = new NumberFormatter(); nf.setStyle("locale", "en-US"); nf.errorText = "###" trace(nf.format("abc")); // ###
Der Standardwert ist null.
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 errorText():String
public function set errorText(value:String):void
Verwandte API-Elemente
fractionalDigits | Eigenschaft |
fractionalDigits:int
Sprachversion: | ActionScript 3.0 |
Produktversion: | Flex 4.5 |
Laufzeitversionen: | Flash Player 10, AIR 2.5 |
Die Höchstzahl von Ziffern, die nach dem Dezimaltrennzeichen erscheinen können.
Zahlen werden auf die Anzahl von Ziffern gerundet, die mit dieser Eigenschaft angegeben wird. Das Rundungsschema variiert je nach Betriebssystem des Benutzers.
Wenn die trailingZeros
-Eigenschaft den Wert true
hat, werden dem gebrochenen Teil der Zahl (nach dem Dezimalzeichen) Nullen nachgestellt, bis die Länge mit dem Wert dieser fractionalDigits
-Eigenschaft übereinstimmt.
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 fractionalDigits():int
public function set fractionalDigits(value:int):void
Verwandte API-Elemente
groupingPattern | Eigenschaft |
groupingPattern:String
Sprachversion: | ActionScript 3.0 |
Produktversion: | Flex 4.5 |
Laufzeitversionen: | Flash Player 10, AIR 2.5 |
Beschreibt die Platzierung von Gruppierungstrennzeichen innerhalb des formatierten Zahlenstrings.
Wenn die useGrouping
-Eigenschaft den Wert „true“ hat, wird die groupingPattern
-Eigenschaft verwendet, um die Platzierung und das Muster für das Gruppierungstrennzeichen zu definieren.
Das Gruppierungsmuster wird als String definiert, der Zahlen enthält, die durch Kommas getrennt sind, und der optional mit einem Asterisk enden kann. Beispiel: "3;2;*"
. Jede Zahl in diesem String repräsentiert die Anzahl der Ziffern in einer Gruppe. Das Gruppierungstrennzeichen wird vor jeder Gruppe von Ziffern platziert. Ein Asterisk am Ende des Strings gibt an, dass Gruppen mit dieser Anzahl von Ziffern für den verbleibenden Rest des Strings wiederholt werden sollen. Fehlt der Asterisk, gibt es im Rest des formatierten Strings keine weiteren Gruppen oder Trennzeichen.
Die erste Zahl im String entspricht der ersten Gruppe von Ziffern links des Dezimaltrennzeichens. Die weiteren Zahlen geben die Anzahl von Ziffern in nach links aufeinander folgenden Gruppen an. Der String "3;2;*"
gibt also an, dass ein Gruppierungstrennzeichen nach der ersten Gruppe mit 3 Ziffern gesetzt wird, dann nach der nächsten Gruppe mit 2 Ziffern. Beispiel: 98,76,54,321
In der folgenden Tabelle sind Beispiele für die Formatierung der Zahl 123456789.12 mit verschiedenen Gruppierungsmustern aufgeführt. Als Gruppierungstrennzeichen wird ein Komma, als Dezimalzeichen ein Punkt verwendet.
Gruppierungsmuster | Beispielformat |
3;* | 123,456,789.12 |
3;2;* | 12,34,56,789.12 |
3 | 123456,789.12 |
Es kann nur eine begrenzte Anzahl von Gruppengrößen definiert werden. Bei einigen Betriebssystemen können Gruppierungsmuster nur zwei Zahlen und einen Asterisk enthalten. Andere Betriebssysteme unterstützen bis zu vier Zahlen und einen Asterisk. Bei Mustern ohne Asterisk unterstützen einige Betriebssystem nur eine Zahl, andere bis zu drei Zahlen. Wenn die maximale Anzahl von Elementen in einem Gruppierungsmuster überschritten wird, werden die überzähligen Elemente ignoriert und die lastOperationStatus
-Eigenschaft wird festgelegt, um anzugeben, dass ein Ersatzwert verwendet wird.
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 groupingPattern():String
public function set groupingPattern(value:String):void
Auslöser
TypeError — wenn dieser Eigenschaft ein null-Wert zugewiesen wird.
|
Verwandte API-Elemente
groupingSeparator | Eigenschaft |
groupingSeparator:String
Sprachversion: | ActionScript 3.0 |
Produktversion: | Flex 4.5 |
Laufzeitversionen: | Flash Player 10, AIR 2.5 |
Das Zeichen oder der String, das bzw. der als Gruppierungstrennzeichen verwendet wird.
Der Wert dieser Eigenschaft wird beim Formatieren von Zahlen mit der useGrouping
-Eigenschaft mit dem Wert true
als Gruppierungstrennzeichen verwendet. Diese Eigenschaft wird anfänglich basierend auf dem Gebietsschema, das beim Konstruieren des Formatter-Objekts ausgewählt wurde, festgelegt.
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 groupingSeparator():String
public function set groupingSeparator(value:String):void
Auslöser
TypeError — wenn dieser Eigenschaft ein null-Wert zugewiesen wird.
|
Verwandte API-Elemente
lastOperationStatus | Eigenschaft |
lastOperationStatus:String
[schreibgeschützt] [override] Sprachversion: | ActionScript 3.0 |
Produktversion: | Flex 4.5 |
Laufzeitversionen: | Flash Player 10, AIR 2.5 |
Der Status der letzten Operation, die dieses Klassenobjekt ausgeführt hat. Die lastOperationStatus
-Eigenschaft wird immer festgelegt, wenn der Konstruktor oder eine Methode dieser Klasse aufgerufen oder eine Eigenschaft festgelegt wird. Die möglichen Werte sind in der Beschreibung der einzelnen Methoden aufgeführt.
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 lastOperationStatus():String
leadingZero | Eigenschaft |
leadingZero:Boolean
Sprachversion: | ActionScript 3.0 |
Produktversion: | Flex 4.5 |
Laufzeitversionen: | Flash Player 10, AIR 2.5 |
Gibt an, ob in der formatierten Zahl vorne eine Null angezeigt wird, wenn es keine Ganzzahlen links des Dezimaltrennzeichens gibt.
Wenn diese Eigenschaft den Wert true
hat, wird beim Formatieren von numerischen Werten zwischen -1.0 und 1.0 links des Dezimalzeichens eine Null vorangestellt. Wenn diese Eigenschaft den Wert false
hat, wird keine Null vorangestellt.
Wenn die Zahl zum Beispiel 0.321 lautet und diese Eigenschaft den Wert true
hat, wird die vorangestellte Null in den formatierten String einbezogen. Wenn die Eigenschaft den Wert false
hat, wird keine Null vor das Dezimalzeichen gesetzt. In diesem Fall enthält der String lediglich das Dezimalzeichen, gefolgt von den Dezimalstellen, also .321
.
Die folgende Tabelle enthält Beispiele für die Formatierung von Zahlen anhand der Werte für diese Eigenschaft und die verwandten Eigenschaften fractionalDigits
und trailingZeros
.
trailingZeros | leadingZero | fractionalDigits | 0.12 | 0 |
true | true | 3 | 0.120 | 0.000 |
false | true | 3 | 0.12 | 0 |
true | false | 3 | .120 | .000 |
false | false | 3 | .12 | 0 |
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 leadingZero():Boolean
public function set leadingZero(value:Boolean):void
Auslöser
TypeError — wenn dieser Eigenschaft ein null-Wert zugewiesen wird.
|
Verwandte API-Elemente
negativeSymbol | Eigenschaft |
negativeSymbol:String
Sprachversion: | ActionScript 3.0 |
Produktversion: | Flex 4.5 |
Laufzeitversionen: | Flash Player 10, AIR 2.5 |
Das Negativsymbol, das bei der Formatierung negativer Werte verwendet wird.
Dieses Symbol wird mit dem Format für negative Zahlen verwendet, wenn die formatierte Zahl kleiner als null ist. Es wird nicht verwendet bei Formaten für negative Zahlen, die kein Negativsymbol enthalten (zum Beispiel, wenn negative Zahlen in Klammern gesetzt werden).
Diese Eigenschaft wird auf einen Standardwert für das tatsächlich verwendete Gebietsschema, das beim Konstruieren des Formatters ausgewählt wurde, gesetzt. Es kann ein Wert festgelegt werden, um die Standardeinstellung zu überschreiben.
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 negativeSymbol():String
public function set negativeSymbol(value:String):void
Verwandte API-Elemente
trailingZeros | Eigenschaft |
trailingZeros:Boolean
Sprachversion: | ActionScript 3.0 |
Produktversion: | Flex 4.5 |
Laufzeitversionen: | Flash Player 10, AIR 2.5 |
Gibt an, ob nachfolgende Nullen in einer formatierten Zahl angezeigt werden.
Wenn diese Eigenschaft den Wert true
hat, werden nachfolgende Nullen in den gebrochenen Teil der formatierten Zahl eingeschlossen, und zwar bis zu dem Grenzwert, der mit der fractionalDigits
-Eigenschaft festgelegt wurde. Wenn diese Eigenschaft den Wert false
hat, werden keine nachfolgenden Nullen hinzugefügt.
Lautet der numerische Wert beispielsweise 123.4 und diese Eigenschaft hat den Wert „true“, während die fractionalDigits
-Eigenschaft auf „3“ eingestellt ist, werden im formatierten String nachfolgende Nullen bis zur dritten Dezimalstelle angezeigt, also 123.400
. Wenn diese Eigenschaft den Wert false
hat, werden keine nachfolgenden Nullen angezeigt und der String zeigt nur das Dezimalzeichen, gefolgt von den Dezimalstellen, die nicht null sind, also 123.4
.
Die folgende Tabelle enthält Beispiele für die Formatierung von numerischen Werten anhand der Werte für diese Eigenschaft und die verwandten Eigenschaften fractionalDigits
und leadingZero
.
trailingZeros | leadingZero | fractionalDigits | 0.12 | 0 |
true | true | 3 | 0.120 | 0.000 |
false | true | 3 | 0.12 | 0 |
true | false | 3 | .120 | .000 |
false | false | 3 | .12 | 0 |
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 trailingZeros():Boolean
public function set trailingZeros(value:Boolean):void
Auslöser
TypeError — wenn dieser Eigenschaft ein null-Wert zugewiesen wird.
|
Verwandte API-Elemente
useGrouping | Eigenschaft |
useGrouping:Boolean
Sprachversion: | ActionScript 3.0 |
Produktversion: | Flex 4.5 |
Laufzeitversionen: | Flash Player 10, AIR 2.5 |
Aktiviert die Verwendung des Gruppierungstrennzeichens bei der Formatierung von Zahlen.
Wenn die useGrouping
-Eigenschaft den Wert true
hat, werden Ziffern gruppiert und durch ein Gruppierungstrennzeichen getrennt. Beispiel: 123,456,789.22
Wenn die useGrouping
-Eigenschaft den Wert false
hat, werden die Ziffern nicht gruppiert oder getrennt. Beispiel: 123456789.22
Das Symbol, das als Gruppierungstrennzeichen verwendet wird, wird mit der groupingSeparator
-Eigenschaft definiert. Die Anzahl der Ziffern zwischen den Gruppierungstrennzeichen wird mit der groupingPattern
-Eigenschaft definiert.
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 useGrouping():Boolean
public function set useGrouping(value:Boolean):void
Verwandte API-Elemente
NumberFormatterBase | () | Konstruktor |
public function NumberFormatterBase()
Sprachversion: | ActionScript 3.0 |
Produktversion: | Flex 4.5 |
Laufzeitversionen: | Flash Player 10, AIR 2.5 |
Konstruktor.
Tue Jun 12 2018, 10:04 AM Z