패키지 | spark.formatters.supportClasses |
클래스 | public class NumberFormatterBase |
상속 | NumberFormatterBase GlobalizationBase AdvancedStyleClient EventDispatcher Object |
하위 클래스 | CurrencyFormatter, NumberFormatter |
언어 버전: | ActionScript 3.0 |
제품 버전: | Flex 4.5 |
런타임 버전: | 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" />
관련 API 요소
속성 | 정의 주체 | ||
---|---|---|---|
actualLocaleIDName : String [읽기 전용]
The name of the actual locale ID used by this class object. | GlobalizationBase | ||
className : String [읽기 전용]
The name of the component class. | AdvancedStyleClient | ||
constructor : Object
지정된 객체 인스턴스의 클래스 객체 또는 생성자 함수에 대한 참조입니다. | 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 [재정의] [읽기 전용]
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 [읽기 전용]
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 |
메서드 | 정의 주체 | ||
---|---|---|---|
Constructor. | NumberFormatterBase | ||
addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void
리스너에서 이벤트 알림을 받을 수 있도록 EventDispatcher 객체에 이벤트 리스너 객체를 등록합니다. | EventDispatcher | ||
Deletes a style property from this component instance. | AdvancedStyleClient | ||
이벤트를 이벤트 흐름으로 전달합니다. | EventDispatcher | ||
Returns an Array of CSSStyleDeclaration objects for the type selector
that applies to this component, or null if none exist. | AdvancedStyleClient | ||
[재정의]
Gets a style property that has been set anywhere in this
component's style lookup chain. | GlobalizationBase | ||
Returns true if currentCSSState is not null. | AdvancedStyleClient | ||
EventDispatcher 객체에 특정 유형의 이벤트에 대한 리스너가 등록되어 있는지 여부를 확인합니다. | EventDispatcher | ||
지정된 속성이 객체에 정의되어 있는지 여부를 나타냅니다. | Object | ||
The initialized method is called when this class or a class that
extends this class is used in an MXML declaration. | AdvancedStyleClient | ||
Object 클래스의 인스턴스가 매개 변수로 지정된 객체의 프로토타입 체인에 있는지 여부를 나타냅니다. | Object | ||
Returns true if cssState matches currentCSSState. | AdvancedStyleClient | ||
Determines whether this instance is the same as, or is a subclass of,
the given type. | AdvancedStyleClient | ||
Propagates style changes to the children of this style client
instance. | AdvancedStyleClient | ||
지정된 속성이 존재하고 열거 가능한지 여부를 나타냅니다. | Object | ||
Sets up the internal style cache values so that the
getStyle()
method functions. | AdvancedStyleClient | ||
Registers the EffectManager as one of the event listeners
for each effect event. | AdvancedStyleClient | ||
EventDispatcher 객체에서 리스너를 제거합니다. | EventDispatcher | ||
루프 작업에서 동적 속성을 사용할 수 있는지 여부를 설정합니다. | Object | ||
Sets a style property on this component instance. | AdvancedStyleClient | ||
Detects changes to style properties. | AdvancedStyleClient | ||
Flex calls the stylesInitialized() method when
the styles for a component are first initialized. | AdvancedStyleClient | ||
로캘별 규칙에 따라 서식이 지정된 이 객체의 문자열 표현을 반환합니다. | Object | ||
지정된 객체의 문자열 표현을 반환합니다. | Object | ||
지정된 객체의 프리미티브 값을 반환합니다. | Object | ||
이 EventDispatcher 객체 또는 조상 객체에 지정한 이벤트 유형에 대한 이벤트 리스너가 등록되어 있는지 여부를 확인합니다. | EventDispatcher |
스타일은 일반적이거나 특정 테마와 연결되어 있을 수 있습니다. 일반적인 스타일인 경우 모든 테마와 함께 사용할 수 있지만, 특정 테마와 연결된 스타일인 경우 응용 프로그램이 해당 테마를 사용하는 경우에만 스타일을 사용할 수 있습니다.
decimalSeparator | 속성 |
decimalSeparator:String
언어 버전: | ActionScript 3.0 |
제품 버전: | Flex 4.5 |
런타임 버전: | 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.
이 속성은 데이터 바인딩에 대한 소스로 사용할 수 있습니다. 이 속성을 수정하면 change
이벤트를 전달합니다.
구현
public function get decimalSeparator():String
public function set decimalSeparator(value:String):void
오류
TypeError — if this property is assigned a null value.
|
관련 API 요소
digitsType | 속성 |
digitsType:uint
언어 버전: | ActionScript 3.0 |
제품 버전: | Flex 4.5 |
런타임 버전: | 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.
이 속성은 데이터 바인딩에 대한 소스로 사용할 수 있습니다. 이 속성을 수정하면 change
이벤트를 전달합니다.
구현
public function get digitsType():uint
public function set digitsType(value:uint):void
관련 API 요소
errorText | 속성 |
errorText:String
언어 버전: | ActionScript 3.0 |
제품 버전: | Flex 4.5 |
런타임 버전: | 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.
var nf:NumberFormatter = new NumberFormatter(); nf.setStyle("locale", "en-US"); nf.errorText = "###" trace(nf.format("abc")); // ###
기본값: null.
이 속성은 데이터 바인딩에 대한 소스로 사용할 수 있습니다. 이 속성을 수정하면 change
이벤트를 전달합니다.
구현
public function get errorText():String
public function set errorText(value:String):void
관련 API 요소
fractionalDigits | 속성 |
fractionalDigits:int
언어 버전: | ActionScript 3.0 |
제품 버전: | Flex 4.5 |
런타임 버전: | 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.
이 속성은 데이터 바인딩에 대한 소스로 사용할 수 있습니다. 이 속성을 수정하면 change
이벤트를 전달합니다.
구현
public function get fractionalDigits():int
public function set fractionalDigits(value:int):void
관련 API 요소
groupingPattern | 속성 |
groupingPattern:String
언어 버전: | ActionScript 3.0 |
제품 버전: | Flex 4.5 |
런타임 버전: | 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.
이 속성은 데이터 바인딩에 대한 소스로 사용할 수 있습니다. 이 속성을 수정하면 change
이벤트를 전달합니다.
구현
public function get groupingPattern():String
public function set groupingPattern(value:String):void
오류
TypeError — if this property is assigned a null value.
|
관련 API 요소
groupingSeparator | 속성 |
groupingSeparator:String
언어 버전: | ActionScript 3.0 |
제품 버전: | Flex 4.5 |
런타임 버전: | 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.
이 속성은 데이터 바인딩에 대한 소스로 사용할 수 있습니다. 이 속성을 수정하면 change
이벤트를 전달합니다.
구현
public function get groupingSeparator():String
public function set groupingSeparator(value:String):void
오류
TypeError — if this property is assigned a null value.
|
관련 API 요소
lastOperationStatus | 속성 |
lastOperationStatus:String
[읽기 전용] [재정의] 언어 버전: | ActionScript 3.0 |
제품 버전: | Flex 4.5 |
런타임 버전: | 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.
이 속성은 데이터 바인딩에 대한 소스로 사용할 수 있습니다. 이 속성을 수정하면 change
이벤트를 전달합니다.
구현
override public function get lastOperationStatus():String
leadingZero | 속성 |
leadingZero:Boolean
언어 버전: | ActionScript 3.0 |
제품 버전: | Flex 4.5 |
런타임 버전: | 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.
이 속성은 데이터 바인딩에 대한 소스로 사용할 수 있습니다. 이 속성을 수정하면 change
이벤트를 전달합니다.
구현
public function get leadingZero():Boolean
public function set leadingZero(value:Boolean):void
오류
TypeError — if this property is assigned a null value.
|
관련 API 요소
negativeSymbol | 속성 |
negativeSymbol:String
언어 버전: | ActionScript 3.0 |
제품 버전: | Flex 4.5 |
런타임 버전: | 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.
이 속성은 데이터 바인딩에 대한 소스로 사용할 수 있습니다. 이 속성을 수정하면 change
이벤트를 전달합니다.
구현
public function get negativeSymbol():String
public function set negativeSymbol(value:String):void
관련 API 요소
trailingZeros | 속성 |
trailingZeros:Boolean
언어 버전: | ActionScript 3.0 |
제품 버전: | Flex 4.5 |
런타임 버전: | 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.
이 속성은 데이터 바인딩에 대한 소스로 사용할 수 있습니다. 이 속성을 수정하면 change
이벤트를 전달합니다.
구현
public function get trailingZeros():Boolean
public function set trailingZeros(value:Boolean):void
오류
TypeError — if this property is assigned a null value.
|
관련 API 요소
useGrouping | 속성 |
useGrouping:Boolean
언어 버전: | ActionScript 3.0 |
제품 버전: | Flex 4.5 |
런타임 버전: | 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.
이 속성은 데이터 바인딩에 대한 소스로 사용할 수 있습니다. 이 속성을 수정하면 change
이벤트를 전달합니다.
구현
public function get useGrouping():Boolean
public function set useGrouping(value:Boolean):void
관련 API 요소
NumberFormatterBase | () | 생성자 |
public function NumberFormatterBase()
언어 버전: | ActionScript 3.0 |
제품 버전: | Flex 4.5 |
런타임 버전: | Flash Player 10, AIR 2.5 |
Constructor.
Tue Jun 12 2018, 03:17 PM Z