Adobe® Flash® Platform 用 ActionScript® 3.0 リファレンスガイド
ホーム  |  パッケージおよびクラスリストの非表示 |  パッケージ  |  クラス  |  新機能  |  索引  |  付録  |  英語で表示される理由
フィルター: サーバーからデータを取得しています...
サーバーからデータを取得しています...
spark.formatters.supportClasses 

NumberFormatterBase  - AS3 Flex

パッケージspark.formatters.supportClasses
クラスpublic class NumberFormatterBase
継承NumberFormatterBase Inheritance GlobalizationBase Inheritance AdvancedStyleClient Inheritance EventDispatcher Inheritance Object
サブクラス CurrencyFormatter, NumberFormatter

言語バージョン: ActionScript 3.0
製品バージョン: Flex 4.5
ランタイムバージョン: Flash Player 10, AIR 2.5

NumberFormatterBase クラスは NumberFormatter および CurrencyFormatter クラスの基本クラスです。

MXML シンタックスexpandedMXML シンタックスを隠す

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 エレメント



パブリックプロパティ
 プロパティ定義元
 InheritedactualLocaleIDName : String
[読み取り専用] このクラスオブジェクトで使用される実際のロケール ID の名前。
GlobalizationBase
 InheritedclassName : String
[読み取り専用] コンポーネントクラスの名前です。
AdvancedStyleClient
 Inheritedconstructor : Object
指定されたオブジェクトインスタンスのクラスオブジェクトまたはコンストラクター関数への参照です。
Object
  decimalSeparator : String
小数部を持つ数字のフォーマットまたは解析に使用される小数点記号。
NumberFormatterBase
  digitsType : uint
数字をフォーマットするときに使用される数字のセットを定義します。
NumberFormatterBase
  errorText : String
エラーが発生したときに format() メソッドによって返される置換文字列。
NumberFormatterBase
  fractionalDigits : int
小数点記号の後に表示できる最大桁数。
NumberFormatterBase
  groupingPattern : String
フォーマットされた文字列内のグループ化区切り文字の配置を記述します。
NumberFormatterBase
  groupingSeparator : String
グループ化区切りに使用される文字または文字列。
NumberFormatterBase
 Inheritedid : String
コンポーネントの ID です。
AdvancedStyleClient
 InheritedinheritingStyles : Object
このビジュアルでないスタイルクライアントのインスタンスの継承可能なスタイルを含むオブジェクトです。
AdvancedStyleClient
  lastOperationStatus : String
[オーバーライド] [読み取り専用] このクラスオブジェクトが実行した最新の操作のステータス。
NumberFormatterBase
  leadingZero : Boolean
小数点区切り文字の左側に整数がない場合に、フォーマットされた数値に先頭の 0 を含めるかどうかを指定します。
NumberFormatterBase
 InheritedmoduleFactory : IFlexModuleFactory
モジュールファクトリは、このビジュアルでないスタイルクライアントのインスタンスのスタイルを制御するスタイルマネージャーを検索するためのコンテキストとして使用されます。
AdvancedStyleClient
  negativeSymbol : String
負の値をフォーマットするときに使用されるマイナス記号。
NumberFormatterBase
 InheritednonInheritingStyles : Object
このコンポーネントの非継承スタイルのチェーンの始まりです。
AdvancedStyleClient
 InheritedstyleDeclaration : CSSStyleDeclaration
このオブジェクトで宣言されたインラインスタイルを保持するスタイル宣言です。
AdvancedStyleClient
 InheritedstyleManager : IStyleManager2
[読み取り専用] このコンポーネントで使用する StyleManager インスタンスを返します。
AdvancedStyleClient
 InheritedstyleName : Object
オブジェクトのスタイル値のソースです。
AdvancedStyleClient
 InheritedstyleParent : IAdvancedStyleClient
コンポーネントの親は、下位要素のセレクターを評価するために使用されます。
AdvancedStyleClient
  trailingZeros : Boolean
末尾の 0 をフォーマットされた数値に含めるかどうかを指定します。
NumberFormatterBase
  useGrouping : Boolean
数字をフォーマットするときに、グループ化区切りを使用できるようにします。
NumberFormatterBase
パブリックメソッド
 メソッド定義元
  
コンストラクターです。
NumberFormatterBase
 Inherited
addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void
イベントリスナーオブジェクトを EventDispatcher オブジェクトに登録し、リスナーがイベントの通知を受け取るようにします。
EventDispatcher
 Inherited
このコンポーネントインスタンスからスタイルプロパティを削除します。
AdvancedStyleClient
 Inherited
イベントをイベントフローに送出します。
EventDispatcher
 Inherited
このコンポーネントに適用されるタイプセレクターの CSSStyleDeclaration オブジェクトの配列を返します。何も存在しない場合は null を返します。
AdvancedStyleClient
 Inherited
getStyle(styleProp:String):*
[オーバーライド] このコンポーネントのスタイル参照チェーンのいずれかの場所に設定されたスタイルプロパティを取得します。
GlobalizationBase
 Inherited
currentCSSState が null でない場合、true を返します。
AdvancedStyleClient
 Inherited
EventDispatcher オブジェクトに、特定のイベントタイプに対して登録されたリスナーがあるかどうかを確認します。
EventDispatcher
 Inherited
オブジェクトに指定されたプロパティが定義されているかどうかを示します。
Object
 Inherited
initialized メソッドは、このクラスまたはこのクラスを拡張するクラスが MXML 宣言で使用されると呼び出されます。
AdvancedStyleClient
 Inherited
Object クラスのインスタンスが、パラメーターとして指定されたオブジェクトのプロトタイプチェーン内にあるかどうかを示します。
Object
 Inherited
cssState が currentCSSState に一致した場合は、true を返します。
AdvancedStyleClient
 Inherited
このインスタンスが、指定されたタイプと同じであるのか、それともそのサブクラスであるのかを判別します。
AdvancedStyleClient
 Inherited
スタイルの変更を、このスタイルクライアントのインスタンスの子に通知します。
AdvancedStyleClient
 Inherited
指定されたプロパティが存在し、列挙できるかどうかを示します。
Object
 Inherited
getStyle() メソッドが機能するように、内部のスタイルキャッシュ値を設定します。
AdvancedStyleClient
 Inherited
各エフェクトイベントのイベントリスナーの 1 つとして、EffectManager を登録します。
AdvancedStyleClient
 Inherited
removeEventListener(type:String, listener:Function, useCapture:Boolean = false):void
EventDispatcher オブジェクトからリスナーを削除します。
EventDispatcher
 Inherited
ループ処理に対するダイナミックプロパティの可用性を設定します。
Object
 Inherited
setStyle(styleProp:String, newValue:*):void
このコンポーネントインスタンスのスタイルプロパティを設定します。
AdvancedStyleClient
 Inherited
スタイルプロパティの変更を検出します。
AdvancedStyleClient
 Inherited
コンポーネントのスタイルを初めて初期化するとき、Flex は stylesInitialized() メソッドを呼び出します。
AdvancedStyleClient
 Inherited
ロケール固有の規則に従って書式設定された、このオブジェクトのストリング表現を返します。
Object
 Inherited
指定されたオブジェクトのストリング表現を返します。
Object
 Inherited
指定されたオブジェクトのプリミティブな値を返します。
Object
 Inherited
指定されたイベントタイプについて、この EventDispatcher オブジェクトまたはその祖先にイベントリスナーが登録されているかどうかを確認します。
EventDispatcher
イベント
 イベント 概要 定義元
 Inherited[ブロードキャストイベント] Flash Player または AIR アプリケーションがオペレーティングシステムのフォーカスを取得して、アクティブになったときに送出されます。EventDispatcher
 Inherited変更イベントは、ロケールスタイルが変更された場合、および、別のプロパティが設定されたことによって、数値のフォーマットが変更されたり、このクラスを通じて使用可能な他の値が更新されたりした場合に、常に生成されます。GlobalizationBase
 Inherited[ブロードキャストイベント] Flash Player または AIR アプリケーションがオペレーティングシステムのフォーカスを失って、非アクティブになったときに送出されます。EventDispatcher
スタイル

スタイルには共通スタイルと特定のテーマに関連するスタイルがあります。共通スタイルは、任意のテーマと共に使用できます。特定のテーマに関連するスタイルは、アプリケーションがそのテーマを使用する場合にのみ使用できます。

共通スタイル
 スタイル 説明 定義元
 Inherited型: String CSS 継承: はい
言語バージョン: ActionScript 3.0  製品バージョン: Flex 4.5  ランタイムバージョン: Flash10.1, AIR 2.5

言語、地域、スクリプトおよびオプションで他の関連するタグおよびキーを指定するロケール識別子です.
GlobalizationBase
プロパティの詳細

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
3123456,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():String

leadingZero

プロパティ 
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 の関連プロパティの値に基づいて数値をフォーマットする方法の例を示しています。

trailingZerosleadingZerofractionalDigits0.120
truetrue30.1200.000
falsetrue30.120
truefalse3.120.000
falsefalse3.120

デフォルト値はロケールおよびオペレーティングシステムによって異なります。

このプロパティはデータバインディングのソースとして使用できます。 このプロパティを変更すると、 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 の関連プロパティの値に基づいて数値をフォーマットする方法の例を示しています。

trailingZerosleadingZerofractionalDigits0.120
truetrue30.1200.000
falsetrue30.120
truefalse3.120.000
falsefalse3.120

デフォルト値はロケールおよびオペレーティングシステムによって異なります。

このプロパティはデータバインディングのソースとして使用できます。 このプロパティを変更すると、 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

コンストラクターです。





[ X ]英語で表示される理由
ActionScript 3.0 リファレンスガイドのコンテンツが英語で表示されます。

ActionScript 3.0 リファレンスガイドのすべての部分がすべての言語に翻訳されているわけではありません。言語エレメントが翻訳されていない場合、そのエレメントは英語で表示されます。例えば、ga.controls.HelpBox クラスはどの言語にも訳されていません。このため、リファレンスガイドの日本語バージョンでは、ga.controls.HelpBox クラスは英語で表示されます。