| パッケージ | 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 |
MXML シンタックスを表示
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"
/>
関連する API エレメント
| プロパティ | 定義元 | ||
|---|---|---|---|
 | actualLocaleIDName : String [読み取り専用]
このクラスオブジェクトで使用される実際のロケール ID の名前。 | GlobalizationBase | |
| className : String [読み取り専用]
コンポーネントクラスの名前です。 | AdvancedStyleClient | |
| constructor : Object
指定されたオブジェクトインスタンスのクラスオブジェクトまたはコンストラクター関数への参照です。 | Object | |
| decimalSeparator : String
小数部を持つ数字のフォーマットまたは解析に使用される小数点記号。 | NumberFormatterBase | ||
| digitsType : uint
数字をフォーマットするときに使用される数字のセットを定義します。 | NumberFormatterBase | ||
| errorText : String
エラーが発生したときに format() メソッドによって返される置換文字列。 | NumberFormatterBase | ||
| fractionalDigits : int
小数点記号の後に表示できる最大桁数。 | NumberFormatterBase | ||
| groupingPattern : String
フォーマットされた文字列内のグループ化区切り文字の配置を記述します。 | NumberFormatterBase | ||
| groupingSeparator : String
グループ化区切りに使用される文字または文字列。 | NumberFormatterBase | ||
| id : String
コンポーネントの ID です。 | AdvancedStyleClient | |
| inheritingStyles : Object
このビジュアルでないスタイルクライアントのインスタンスの継承可能なスタイルを含むオブジェクトです。 | AdvancedStyleClient | |
| lastOperationStatus : String [オーバーライド] [読み取り専用]
このクラスオブジェクトが実行した最新の操作のステータス。 | NumberFormatterBase | ||
| leadingZero : Boolean
小数点区切り文字の左側に整数がない場合に、フォーマットされた数値に先頭の 0 を含めるかどうかを指定します。 | NumberFormatterBase | ||
| moduleFactory : IFlexModuleFactory
モジュールファクトリは、このビジュアルでないスタイルクライアントのインスタンスのスタイルを制御するスタイルマネージャーを検索するためのコンテキストとして使用されます。 | AdvancedStyleClient | |
| negativeSymbol : String
負の値をフォーマットするときに使用されるマイナス記号。 | NumberFormatterBase | ||
| nonInheritingStyles : Object
このコンポーネントの非継承スタイルのチェーンの始まりです。 | AdvancedStyleClient | |
| styleDeclaration : CSSStyleDeclaration
このオブジェクトで宣言されたインラインスタイルを保持するスタイル宣言です。 | AdvancedStyleClient | |
| styleManager : IStyleManager2 [読み取り専用]
このコンポーネントで使用する StyleManager インスタンスを返します。 | AdvancedStyleClient | |
| styleName : Object
オブジェクトのスタイル値のソースです。 | AdvancedStyleClient | |
| styleParent : IAdvancedStyleClient
コンポーネントの親は、下位要素のセレクターを評価するために使用されます。 | AdvancedStyleClient | |
| trailingZeros : Boolean
末尾の 0 をフォーマットされた数値に含めるかどうかを指定します。 | NumberFormatterBase | ||
| useGrouping : Boolean
数字をフォーマットするときに、グループ化区切りを使用できるようにします。 | NumberFormatterBase | ||
| メソッド | 定義元 | ||
|---|---|---|---|
コンストラクターです。 | NumberFormatterBase | ||
| addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void
イベントリスナーオブジェクトを EventDispatcher オブジェクトに登録し、リスナーがイベントの通知を受け取るようにします。 | EventDispatcher | |
|
このコンポーネントインスタンスからスタイルプロパティを削除します。 | AdvancedStyleClient | |
|
イベントをイベントフローに送出します。 | EventDispatcher | |
|
このコンポーネントに適用されるタイプセレクターの CSSStyleDeclaration オブジェクトの配列を返します。何も存在しない場合は null を返します。 | AdvancedStyleClient | |
| [オーバーライド]
このコンポーネントのスタイル参照チェーンのいずれかの場所に設定されたスタイルプロパティを取得します。 | GlobalizationBase | |
|
currentCSSState が null でない場合、true を返します。 | AdvancedStyleClient | |
|
EventDispatcher オブジェクトに、特定のイベントタイプに対して登録されたリスナーがあるかどうかを確認します。 | EventDispatcher | |
|
オブジェクトに指定されたプロパティが定義されているかどうかを示します。 | Object | |
|
initialized メソッドは、このクラスまたはこのクラスを拡張するクラスが MXML 宣言で使用されると呼び出されます。 | AdvancedStyleClient | |
|
Object クラスのインスタンスが、パラメーターとして指定されたオブジェクトのプロトタイプチェーン内にあるかどうかを示します。 | Object | |
|
cssState が currentCSSState に一致した場合は、true を返します。 | AdvancedStyleClient | |
|
このインスタンスが、指定されたタイプと同じであるのか、それともそのサブクラスであるのかを判別します。 | AdvancedStyleClient | |
|
スタイルの変更を、このスタイルクライアントのインスタンスの子に通知します。 | AdvancedStyleClient | |
|
指定されたプロパティが存在し、列挙できるかどうかを示します。 | Object | |
|
getStyle() メソッドが機能するように、内部のスタイルキャッシュ値を設定します。 | AdvancedStyleClient | |
|
各エフェクトイベントのイベントリスナーの 1 つとして、EffectManager を登録します。 | AdvancedStyleClient | |
|
EventDispatcher オブジェクトからリスナーを削除します。 | EventDispatcher | |
|
ループ処理に対するダイナミックプロパティの可用性を設定します。 | Object | |
|
このコンポーネントインスタンスのスタイルプロパティを設定します。 | AdvancedStyleClient | |
|
スタイルプロパティの変更を検出します。 | AdvancedStyleClient | |
|
コンポーネントのスタイルを初めて初期化するとき、Flex は stylesInitialized() メソッドを呼び出します。 | AdvancedStyleClient | |
|
ロケール固有の規則に従って書式設定された、このオブジェクトのストリング表現を返します。 | Object | |
|
指定されたオブジェクトのストリング表現を返します。 | Object | |
|
指定されたオブジェクトのプリミティブな値を返します。 | Object | |
|
指定されたイベントタイプについて、この EventDispatcher オブジェクトまたはその祖先にイベントリスナーが登録されているかどうかを確認します。 | EventDispatcher | |
スタイルには共通スタイルと特定のテーマに関連するスタイルがあります。共通スタイルは、任意のテーマと共に使用できます。特定のテーマに関連するスタイルは、アプリケーションがそのテーマを使用する場合にのみ使用できます。
decimalSeparator | プロパティ |
decimalSeparator:String| 言語バージョン: | ActionScript 3.0 |
| 製品バージョン: | Flex 4.5 |
| ランタイムバージョン: | Flash Player 10, AIR 2.5 |
小数部を持つ数字のフォーマットまたは解析に使用される小数点記号。
デフォルト値はロケールおよびオペレーティングシステムによって異なります。
このプロパティはデータバインディングのソースとして使用できます。 このプロパティを変更すると、 change イベントが送出されます。
実装
public function get decimalSeparator():String public function set decimalSeparator(value:String):void例外
TypeError — このプロパティに null 値が割り当てられている場合。
|
関連する API エレメント
digitsType | プロパティ |
digitsType:uint| 言語バージョン: | ActionScript 3.0 |
| 製品バージョン: | Flex 4.5 |
| ランタイムバージョン: | Flash Player 10, AIR 2.5 |
数字をフォーマットするときに使用される数字のセットを定義します。
さまざまな言語と地域で使用されるさまざまな文字セットを、0～9 の数字で表します。 このプロパティは、使用される数字のセットを定義します。
このプロパティの値は、10 進数字セットのゼロ桁の Unicode 値を表しています。このプロパティの有効な値は NationalDigitsType クラスで定義されています。
デフォルト値はロケールおよびオペレーティングシステムによって異なります。
このプロパティはデータバインディングのソースとして使用できます。 このプロパティを変更すると、 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 |
エラーが発生したときに format() メソッドによって返される置換文字列。
errorText が null でなく、数値または通貨額のフォーマット中にエラーが発生した場合、format メソッドはこのプロパティに割り当てられた文字列を返します。
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 |
小数点記号の後に表示できる最大桁数。
数字はこのプロパティによって指定された桁数に丸められます。丸めのスキームは、アプリケーションユーザーのオペレーティングシステムによって異なります。
trailingZeros プロパティが true に設定されると、数字の小数部分（小数区切り記号の後）にこの fractionalDigits プロパティの値に一致する長さまで、0 が置かれます。
デフォルト値はロケールおよびオペレーティングシステムによって異なります。
このプロパティはデータバインディングのソースとして使用できます。 このプロパティを変更すると、 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 |
フォーマットされた文字列内のグループ化区切り文字の配置を記述します。
useGrouping プロパティが true に設定されると、groupingPattern プロパティを使用して、グループ化区切り文字に使用される配置とパターンが定義されます。
グループ化パターンはセミコロンで区切られ、場合によっては最後にアスタリスクが付く数字を含む文字列として定義されます。例： "3;2;*"文字列内のそれぞれの数字は、グループ内の桁数を表しています。グループセパレーターは、各数字グループの前に置かれます。ストリングの最後のアスタリスクは、その桁数を持つグループが、フォーマットされた残りのストリングで繰り返されることを示しています。アスタリスクがない場合、フォーマットされた残りのストリングに追加のグループやセパレーターはありません。
文字列内の最初の数字は、小数点の左側の数字の最初のグループに対応しています。その後に続く数字は、左側の後続のグループの桁数を定義します。 このため、文字列「3;2;*」はグループ化区切り文字が最初の 3 桁のグループの後に置かれ、その後に 2 桁のグループが続くことを示しています。 例： 98,76,54,321
次の表は、さまざまなグループ化パターンによる数字 123456789.12 のフォーマットの例を示しています。グループ化の区切り文字はカンマで、小数点はピリオドです。
| グループ化パターン | サンプルフォーマット |
3;* | 123,456,789.12 |
3;2;* | 12,34,56,789.12 |
3 | 123456,789.12 |
限定された数のグループ化サイズのみ定義できます。一部のオペレーティングシステムは、グループ化パターンに 2 つの数字とアスタリスクのみ含むことができます。 その他のオペレーティングシステムは、4 つまでの数字とアスタリスクを含むことができます。アスタリスクがないパターンの場合、一部のオペレーティングシステムは 1 つの数字のみサポートし、その他のオペレーティングシステムは 3 つまでの数字をサポートします。グループ化パターンエレメントの最大数を超える場合、追加エレメントは無視され、lastOperationStatus プロパティは代替値が使用されることを示すように設定されます。
デフォルト値はロケールおよびオペレーティングシステムによって異なります。
このプロパティはデータバインディングのソースとして使用できます。 このプロパティを変更すると、 change イベントが送出されます。
実装
public function get groupingPattern():String public function set groupingPattern(value:String):void例外
TypeError — このプロパティに null 値が割り当てられている場合。
|
関連する API エレメント
groupingSeparator | プロパティ |
groupingSeparator:String| 言語バージョン: | ActionScript 3.0 |
| 製品バージョン: | Flex 4.5 |
| ランタイムバージョン: | Flash Player 10, AIR 2.5 |
グループ化区切りに使用される文字または文字列。
useGrouping プロパティが true に設定されている数字をフォーマットするときに、このプロパティの値がグループ化区切り文字として使用されます。 このプロパティは最初、formatter オブジェクトを構築するときに選択したロケールに基づいて設定されます。
デフォルト値はロケールおよびオペレーティングシステムによって異なります。
このプロパティはデータバインディングのソースとして使用できます。 このプロパティを変更すると、 change イベントが送出されます。
実装
public function get groupingSeparator():String public function set groupingSeparator(value:String):void例外
TypeError — このプロパティに null 値が割り当てられている場合。
|
関連する API エレメント
lastOperationStatus | プロパティ |
lastOperationStatus:String [読み取り専用] [オーバーライド] | 言語バージョン: | ActionScript 3.0 |
| 製品バージョン: | Flex 4.5 |
| ランタイムバージョン: | Flash Player 10, AIR 2.5 |
このクラスオブジェクトが実行した最新の操作のステータス。コンストラクターまたはこのクラスのメソッドが呼び出されたり、プロパティが設定されたりすると、必ず lastOperationStatus が設定されます。有効な値については、各メソッドの説明を参照してください。
このプロパティはデータバインディングのソースとして使用できます。 このプロパティを変更すると、 change イベントが送出されます。
実装
override public function get lastOperationStatus():StringleadingZero | プロパティ |
leadingZero:Boolean| 言語バージョン: | ActionScript 3.0 |
| 製品バージョン: | Flex 4.5 |
| ランタイムバージョン: | Flash Player 10, AIR 2.5 |
小数点区切り文字の左側に整数がない場合に、フォーマットされた数値に先頭の 0 を含めるかどうかを指定します。
このプロパティが true に設定されている場合、-1.0 ～ 1.0 の数値をフォーマットするときに、小数点記号の左側に先頭の 0 が含まれます。このプロパティが false に設定されている場合、0 は含まれません。
例えば、数値が 0.321 でこのプロパティが true に設定されている場合、フォーマットされた文字列に先頭の 0 が含まれます。 プロパティが false に設定されている場合、先頭の 0 は含まれません。その場合、文字列には、.321 のように小数点記号とその後に続く 10 進数の数字が含まれます。
次の表は、このプロパティと fractionalDigits および 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 |
デフォルト値はロケールおよびオペレーティングシステムによって異なります。
このプロパティはデータバインディングのソースとして使用できます。 このプロパティを変更すると、 change イベントが送出されます。
実装
public function get leadingZero():Boolean public function set leadingZero(value:Boolean):void例外
TypeError — このプロパティに null 値が割り当てられている場合。
|
関連する API エレメント
negativeSymbol | プロパティ |
negativeSymbol:String| 言語バージョン: | ActionScript 3.0 |
| 製品バージョン: | Flex 4.5 |
| ランタイムバージョン: | Flash Player 10, AIR 2.5 |
負の値をフォーマットするときに使用されるマイナス記号。
この記号は、0 よりも小さい数値をフォーマットするときに、負の数値のフォーマットと組み合わせて使用されます。負の記号を含まない負の数値のフォーマットでは使用されません（例えば、負の数値が括弧で囲まれている場合）。
このプロパティは、このフォーマッターを構築するときに選択した実際のロケールのデフォルト値に設定されます。値を設定して、デフォルト設定を無効にすることができます。
デフォルト値はロケールおよびオペレーティングシステムによって異なります。
このプロパティはデータバインディングのソースとして使用できます。 このプロパティを変更すると、 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 |
末尾の 0 をフォーマットされた数値に含めるかどうかを指定します。
このプロパティが true に設定されている場合、末尾の 0 が fractionalDigits プロパティで指定された限界までフォーマットされた数値の小数部分に含まれます。このプロパティが false に設定されている場合、末尾の 0 は表示されません。
例えば、数値が 123.4 で、このプロパティが true に設定されている場合、fractionalDigits プロパティは 3 に設定され、フォーマットされた文字列には 123.400 のように末尾の 0 が表示されます。 このプロパティが false の場合、末尾の 0 は含まれず、文字列には 123.4 のように小数点記号とその後に続くゼロ以外の 10 進数の数字が表示されます。
次の表は、このプロパティと fractionalDigits および 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 |
デフォルト値はロケールおよびオペレーティングシステムによって異なります。
このプロパティはデータバインディングのソースとして使用できます。 このプロパティを変更すると、 change イベントが送出されます。
実装
public function get trailingZeros():Boolean public function set trailingZeros(value:Boolean):void例外
TypeError — このプロパティに null 値が割り当てられている場合。
|
関連する API エレメント
useGrouping | プロパティ |
useGrouping:Boolean| 言語バージョン: | ActionScript 3.0 |
| 製品バージョン: | Flex 4.5 |
| ランタイムバージョン: | Flash Player 10, AIR 2.5 |
数字をフォーマットするときに、グループ化区切りを使用できるようにします。
useGrouping プロパティが true に設定されている場合、数字はグループ化され、グループセパレーター文字で区切られます。例：123,456,789.22
useGrouping プロパティが false に設定されている場合、数字はグループ化されず、区切られません。例：123456789.22
グループ化区切りとして使用される記号は groupingSeparator プロパティによって定義されます。グループ化区切り間の桁数は、groupingPattern プロパティによって定義されます。
デフォルト値はロケールおよびオペレーティングシステムによって異なります。
このプロパティはデータバインディングのソースとして使用できます。 このプロパティを変更すると、 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 |
コンストラクターです。
Tue Jun 12 2018, 10:34 AM Z