NumberFormatterBase

Pacchetto	spark.formatters.supportClasses
Classe	public class NumberFormatterBase
Ereditarietà	NumberFormatterBase GlobalizationBase AdvancedStyleClient EventDispatcher Object
Sottoclassi	CurrencyFormatter, NumberFormatter

Versione linguaggio:

ActionScript 3.0

Versione prodotto:

Flex 4.5

Versioni runtime:

Flash Player 10, AIR 2.5

The NumberFormatterBase class is a base class for the NumberFormatter and CurrencyFormatter classes.

Sintassi MXML expanded

Nascondi sintassi MXML

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

Elementi API correlati

spark.formatters.CurrencyFormatter
spark.formatters.NumberFormatter

Proprietà pubbliche

Nascondi proprietà pubbliche ereditate

Mostra proprietà pubbliche ereditate

	Proprietà		Definito da
		actualLocaleIDName : String [sola lettura] The name of the actual locale ID used by this class object.	GlobalizationBase
		className : String [sola lettura] The name of the component class.	AdvancedStyleClient
		constructor : Object Un riferimento all'oggetto classe o alla funzione di costruzione per una determinata istanza di oggetto.	Object
		decimalSeparator : String The decimal separator character used for formatting or parsing numbers that have a decimal part.	NumberFormatterBase
		digitsType : uint Defines the set of digit characters to be used when formatting numbers.	NumberFormatterBase
		errorText : String Replacement string returned by the format() method when an error occurs.	NumberFormatterBase
		fractionalDigits : int The maximum number of digits that can appear after the decimal separator.	NumberFormatterBase
		groupingPattern : String Describes the placement of grouping separators within the formatted number string.	NumberFormatterBase
		groupingSeparator : String The character or string used for the grouping separator.	NumberFormatterBase
		id : String The identity of the component.	AdvancedStyleClient
		inheritingStyles : Object An object containing the inheritable styles for this non-visual style client instance.	AdvancedStyleClient
		lastOperationStatus : String [override] [sola lettura] The status of the most recent operation that this class object performed.	NumberFormatterBase
		leadingZero : Boolean Specifies whether a leading zero is included in a formatted number when there are no integer digits to the left of the decimal separator.	NumberFormatterBase
		moduleFactory : IFlexModuleFactory A module factory is used as context for finding the style manager that controls the styles for this non-visual style client instance.	AdvancedStyleClient
		negativeSymbol : String The negative symbol to be used when formatting negative values.	NumberFormatterBase
		nonInheritingStyles : Object The beginning of this component's chain of non-inheriting styles.	AdvancedStyleClient
		styleDeclaration : CSSStyleDeclaration The style declaration that holds the inline styles declared by this object.	AdvancedStyleClient
		styleManager : IStyleManager2 [sola lettura] Returns the StyleManager instance used by this component.	AdvancedStyleClient
		styleName : Object The source of this object's style values.	AdvancedStyleClient
		styleParent : IAdvancedStyleClient A component's parent is used to evaluate descendant selectors.	AdvancedStyleClient
		trailingZeros : Boolean Specifies whether trailing zeros are included in a formatted number.	NumberFormatterBase
		useGrouping : Boolean Enables the use of the grouping separator when formatting numbers.	NumberFormatterBase

Metodi pubblici

Nascondi metodi pubblici ereditati

Mostra metodi pubblici ereditati

	Metodo		Definito da
		NumberFormatterBase() Constructor.	NumberFormatterBase
		addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void Registra un oggetto listener di eventi con un oggetto EventDispatcher, in modo che il listener riceva la notifica di un evento.	EventDispatcher
		clearStyle(styleProp:String):void Deletes a style property from this component instance.	AdvancedStyleClient
		dispatchEvent(event:Event):Boolean Invia un evento nel flusso di eventi.	EventDispatcher
		getClassStyleDeclarations():Array Returns an Array of CSSStyleDeclaration objects for the type selector that applies to this component, or null if none exist.	AdvancedStyleClient
		getStyle(styleProp:String):* [override] Gets a style property that has been set anywhere in this component's style lookup chain.	GlobalizationBase
		hasCSSState():Boolean Returns true if currentCSSState is not null.	AdvancedStyleClient
		hasEventListener(type:String):Boolean Verifica se per l'oggetto EventDispatcher sono presenti listener registrati per un tipo specifico di evento.	EventDispatcher
		hasOwnProperty(name:String):Boolean Indica se per un oggetto è definita una proprietà specifica.	Object
		initialized(document:Object, id:String):void The initialized method is called when this class or a class that extends this class is used in an MXML declaration.	AdvancedStyleClient
		isPrototypeOf(theClass:Object):Boolean Indica se un'istanza della classe Object si trova nella catena di prototipi dell'oggetto specificato come parametro.	Object
		matchesCSSState(cssState:String):Boolean Returns true if cssState matches currentCSSState.	AdvancedStyleClient
		matchesCSSType(cssType:String):Boolean Determines whether this instance is the same as, or is a subclass of, the given type.	AdvancedStyleClient
		notifyStyleChangeInChildren(styleProp:String, recursive:Boolean):void Propagates style changes to the children of this style client instance.	AdvancedStyleClient
		propertyIsEnumerable(name:String):Boolean Indica se la proprietà specificata esiste ed è enumerabile.	Object
		regenerateStyleCache(recursive:Boolean):void Sets up the internal style cache values so that the getStyle() method functions.	AdvancedStyleClient
		registerEffects(effects:Array):void Registers the EffectManager as one of the event listeners for each effect event.	AdvancedStyleClient
		removeEventListener(type:String, listener:Function, useCapture:Boolean = false):void Rimuove un listener dall'oggetto EventDispatcher.	EventDispatcher
		setPropertyIsEnumerable(name:String, isEnum:Boolean = true):void Imposta la disponibilità di una proprietà dinamica per le operazioni cicliche.	Object
		setStyle(styleProp:String, newValue:*):void Sets a style property on this component instance.	AdvancedStyleClient
		styleChanged(styleProp:String):void Detects changes to style properties.	AdvancedStyleClient
		stylesInitialized():void Flex calls the stylesInitialized() method when the styles for a component are first initialized.	AdvancedStyleClient
		toLocaleString():String Restituisce la rappresentazione in formato stringa di questo oggetto, formattato in base alle convenzioni specifiche per le versioni localizzate.	Object
		toString():String Restituisce la rappresentazione in formato stringa dell'oggetto specificato.	Object
		valueOf():Object Restituisce il valore di base dell'oggetto specificato.	Object
		willTrigger(type:String):Boolean Verifica se un listener di eventi è registrato con questo oggetto EventDispatcher o qualsiasi suo antenato per il tipo di evento specificato.	EventDispatcher

Eventi

Fate clic per visualizzare altre informazioni sugli eventi

Nascondi eventi ereditati

Mostra eventi ereditati

	Riepilogo	Definito da
activate	[evento di trasmissione] Inviato quando Flash Player o l'applicazione AIR ottiene lo stato di attivazione del sistema operativo ed entra nello stato attivo.	EventDispatcher
change	The change event is generated whenever the locale style is changed or another property is set that would cause the format of a number to change or cause updates to the other values available through this class.	GlobalizationBase
deactivate	[evento di trasmissione] Inviato quando Flash Player o l'applicazione AIR perde l'attivazione del sistema operativo e sta entrando nello stato inattivo.	EventDispatcher

Stili

Gli stili sono di tipo comune oppure associati a un tema specifico. Se lo stile è comune, può essere utilizzato con qualunque tema. Se è associato a un tema specifico, può essere utilizzato solo se la vostra applicazione ne fa uso.

Stili comuni

Fate clic per visualizzare altre informazioni sugli stili

Nascondi stili ereditati

Mostra stili ereditati

	Stile		Descrizione	Definito da
		locale	Tipo: String Ereditarietà CSS: Sì Versione linguaggio: ActionScript 3.0 Versione prodotto: Flex 4.5 Versioni runtime: Flash10.1, AIR 2.5 The locale identifier that specifies the language, region, script and optionally other related tags and keys.	GlobalizationBase

Descrizione delle proprietà

decimalSeparator

proprietà

decimalSeparator:String

Versione linguaggio:

ActionScript 3.0

Versione prodotto:

Flex 4.5

Versioni runtime:

Flash Player 10, AIR 2.5

The decimal separator character used for formatting or parsing numbers that have a decimal part.

The default value is dependent on the locale and operating system.

Questa proprietà può essere utilizzata come origine per l’associazione di dati. Quando questa proprietà viene modificata, invia l’evento change .

Implementazione
public function get decimalSeparator():String
public function set decimalSeparator(value:String):void

Genera

TypeError — if this property is assigned a null value.

Elementi API correlati

spark.formatters.CurrencyFormatter.format()
spark.formatters.NumberFormatter.format()

digitsType

proprietà

digitsType:uint

Versione linguaggio:

ActionScript 3.0

Versione prodotto:

Flex 4.5

Versioni runtime:

Flash Player 10, AIR 2.5

Defines the set of digit characters to be used when formatting numbers.

Different languages and regions use different sets of characters to represent the digits 0 through 9. This property defines the set of digits to be used.

The value of this property represents the Unicode value for the zero digit of a decimal digit set. The valid values for this property are defined in the NationalDigitsType class.

The default value is dependent on the locale and operating system.

Questa proprietà può essere utilizzata come origine per l’associazione di dati. Quando questa proprietà viene modificata, invia l’evento change .

Implementazione
public function get digitsType():uint
public function set digitsType(value:uint):void

Elementi API correlati

flash.globalization.NationalDigitsType

errorText

proprietà

errorText:String

Versione linguaggio:

ActionScript 3.0

Versione prodotto:

Flex 4.5

Versioni runtime:

Flash Player 10, AIR 2.5

Replacement string returned by the format() method when an error occurs.

If errorText is non-null and an error occurs while formatting a number or currency amount, the format method will return the string assigned to this property.

For example:

      var nf:NumberFormatter = new NumberFormatter();
      nf.setStyle("locale", "en-US");
      nf.errorText = "###"
      trace(nf.format("abc"));  // ###

Il valore predefinito è null.

Questa proprietà può essere utilizzata come origine per l’associazione di dati. Quando questa proprietà viene modificata, invia l’evento change .

Implementazione
public function get errorText():String
public function set errorText(value:String):void

Elementi API correlati

spark.globalization.LastOperationStatus

fractionalDigits

proprietà

fractionalDigits:int

Versione linguaggio:

ActionScript 3.0

Versione prodotto:

Flex 4.5

Versioni runtime:

Flash Player 10, AIR 2.5

The maximum number of digits that can appear after the decimal separator.

Numbers are rounded to the number of digits specified by this property. The rounding scheme varies depending on the application user's operating system.

When the trailingZeros property is set to true, the fractional portion of the number (after the decimal separator) is padded with trailing zeros until its length matches the value of this fractionalDigits property.

The default value is dependent on the locale and operating system.

Questa proprietà può essere utilizzata come origine per l’associazione di dati. Quando questa proprietà viene modificata, invia l’evento change .

Implementazione
public function get fractionalDigits():int
public function set fractionalDigits(value:int):void

Elementi API correlati

trailingZeros

groupingPattern

proprietà

groupingPattern:String

Versione linguaggio:

ActionScript 3.0

Versione prodotto:

Flex 4.5

Versioni runtime:

Flash Player 10, AIR 2.5

Describes the placement of grouping separators within the formatted number string.

When the useGrouping property is set to true, the groupingPattern property is used to define the placement and pattern used for the grouping separator.

The grouping pattern is defined as a string containing numbers separated by semicolons and optionally may end with an asterisk. For example: "3;2;*". Each number in the string represents the number of digits in a group. The grouping separator is placed before each group of digits. An asterisk at the end of the string indicates that groups with that number of digits should be repeated for the rest of the formatted string. If there is no asterisk then there are no additional groups or separators for the rest of the formatted string.

The first number in the string corresponds to the first group of digits to the left of the decimal separator. Subsequent numbers define the number of digits in subsequent groups to the left. Thus the string "3;2;*" indicates that a grouping separator is placed after the first group of 3 digits, followed by groups of 2 digits. For example: 98,76,54,321

The following table shows examples of formatting the number 123456789.12 with various grouping patterns. The grouping separator is a comma and the decimal separator is a period.

Grouping Pattern	Sample Format
`3;*`	123,456,789.12
`3;2;*`	12,34,56,789.12
`3`	123456,789.12

Only a limited number of grouping sizes can be defined. On some operating systems, grouping patterns can only contain two numbers plus an asterisk. Other operating systems can support up to four numbers and an asterisk. For patterns without an asterisk, some operating systems only support one number while others support up to three numbers. If the maximum number of grouping pattern elements is exceeded, then additional elements are ignored and the lastOperationStatus property is set to indicate that a fall back value is being used.

The default value is dependent on the locale and operating system.

Questa proprietà può essere utilizzata come origine per l’associazione di dati. Quando questa proprietà viene modificata, invia l’evento change .

Implementazione
public function get groupingPattern():String
public function set groupingPattern(value:String):void

Genera

TypeError — if this property is assigned a null value.

Elementi API correlati

groupingSeparator
useGrouping

groupingSeparator

proprietà

groupingSeparator:String

Versione linguaggio:

ActionScript 3.0

Versione prodotto:

Flex 4.5

Versioni runtime:

Flash Player 10, AIR 2.5

The character or string used for the grouping separator.

The value of this property is used as the grouping separator when formatting numbers with the useGrouping property set to true. This property is initially set based on the locale that is selected when the formatter object is constructed.

The default value is dependent on the locale and operating system.

Questa proprietà può essere utilizzata come origine per l’associazione di dati. Quando questa proprietà viene modificata, invia l’evento change .

Implementazione
public function get groupingSeparator():String
public function set groupingSeparator(value:String):void

Genera

TypeError — if this property is assigned a null value.

Elementi API correlati

spark.formatters.CurrencyFormatter.format()
spark.formatters.NumberFormatter.format()
useGrouping
groupingPattern

lastOperationStatus

proprietà

lastOperationStatus:String [sola lettura] [override]

Versione linguaggio:

ActionScript 3.0

Versione prodotto:

Flex 4.5

Versioni runtime:

Flash Player 10, AIR 2.5

The status of the most recent operation that this class object performed. The lastOperationStatus is set whenever the constructor or a method of this class is called, or when a property is set. For the possible values see the description under each method.

Questa proprietà può essere utilizzata come origine per l’associazione di dati. Quando questa proprietà viene modificata, invia l’evento change .

Implementazione
override public function get lastOperationStatus():String

leadingZero

proprietà

leadingZero:Boolean

Versione linguaggio:

ActionScript 3.0

Versione prodotto:

Flex 4.5

Versioni runtime:

Flash Player 10, AIR 2.5

Specifies whether a leading zero is included in a formatted number when there are no integer digits to the left of the decimal separator.

When this property is set to true a leading zero is included to the left of the decimal separator when formatting numeric values between -1.0 and 1.0. When this property is set to false, a leading zero is not included.

For example, if the number is 0.321 and this property is set true, then the leading zero is included in the formatted string. If the property is set to false, the leading zero is not included. In that case the string would just include the decimal separator followed by the decimal digits, such as .321.

The following table shows examples of how numbers are formatted based on the values of this property and the related fractionalDigits and trailingZeros properties.

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

The default value is dependent on the locale and operating system.

Questa proprietà può essere utilizzata come origine per l’associazione di dati. Quando questa proprietà viene modificata, invia l’evento change .

Implementazione
public function get leadingZero():Boolean
public function set leadingZero(value:Boolean):void

Genera

TypeError — if this property is assigned a null value.

Elementi API correlati

spark.formatters.CurrencyFormatter.format()
spark.formatters.NumberFormatter.format()
trailingZeros

negativeSymbol

proprietà

negativeSymbol:String

Versione linguaggio:

ActionScript 3.0

Versione prodotto:

Flex 4.5

Versioni runtime:

Flash Player 10, AIR 2.5

The negative symbol to be used when formatting negative values.

This symbol is used with the negative number format when formatting a number that is less than zero. It is not used in negative number formats that do not include a negative sign (e.g. when negative numbers are enclosed in parentheses).

This property is set to a default value for the actual locale selected when this formatter is constructed. It can be set with a value to override the default setting.

The default value is dependent on the locale and operating system.

Questa proprietà può essere utilizzata come origine per l’associazione di dati. Quando questa proprietà viene modificata, invia l’evento change .

Implementazione
public function get negativeSymbol():String
public function set negativeSymbol(value:String):void

Elementi API correlati

negativeNumberFormat
format()

trailingZeros

proprietà

trailingZeros:Boolean

Versione linguaggio:

ActionScript 3.0

Versione prodotto:

Flex 4.5

Versioni runtime:

Flash Player 10, AIR 2.5

Specifies whether trailing zeros are included in a formatted number.

When this property is set to true, trailing zeros are included in the fractional part of the formatted number up to the limit specified by the fractionalDigits property. When this property is set to false then no trailing zeros are shown.

For example, if the numeric value is 123.4, and this property is set true, and the fractionalDigits property is set to 3, the formatted string would show trailing zeros, such as 123.400 . If this property is false, trailing zeros are not included, and the string shows just the decimal separator followed by the non-zero decimal digits, such as 123.4.

The following table shows examples of how numeric values are formatted based on the values of this property and the related fractionalDigits and leadingZero properties.

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

The default value is dependent on the locale and operating system.

Questa proprietà può essere utilizzata come origine per l’associazione di dati. Quando questa proprietà viene modificata, invia l’evento change .

Implementazione
public function get trailingZeros():Boolean
public function set trailingZeros(value:Boolean):void

Genera

TypeError — if this property is assigned a null value.

Elementi API correlati

leadingZero

useGrouping

proprietà

useGrouping:Boolean

Versione linguaggio:

ActionScript 3.0

Versione prodotto:

Flex 4.5

Versioni runtime:

Flash Player 10, AIR 2.5

Enables the use of the grouping separator when formatting numbers.

When the useGrouping property is set to true, digits are grouped and delimited by the grouping separator character. For example: 123,456,789.22

When the useGrouping property is set to false, digits are not grouped or separated. For example: 123456789.22

The symbol to be used as a grouping separator is defined by the groupingSeparator property. The number of digits between grouping separators is defined by the groupingPattern property.

The default value is dependent on the locale and operating system.

Questa proprietà può essere utilizzata come origine per l’associazione di dati. Quando questa proprietà viene modificata, invia l’evento change .

Implementazione
public function get useGrouping():Boolean
public function set useGrouping(value:Boolean):void

Elementi API correlati

groupingPattern
groupingSeparator

Descrizione della funzione di costruzione

()

Funzione di costruzione

public function NumberFormatterBase()

Versione linguaggio:

ActionScript 3.0

Versione prodotto:

Flex 4.5

Versioni runtime:

Flash Player 10, AIR 2.5

Constructor.

Note legali | Informativa sulla privacy online

NumberFormatterBase - AS3 Flex

Pacchettix

Elementi del linguaggio

Appendici

Pacchetto spark.formatters.supportClasses

decimalSeparator

digitsType

errorText

fractionalDigits

groupingPattern

groupingSeparator

lastOperationStatus

leadingZero

negativeSymbol

trailingZeros

useGrouping

NumberFormatterBase