パッケージmx.formatters
クラスpublic class SwitchSymbolFormatter
継承SwitchSymbolFormatter Inheritance Object

SwitchSymbolFormatter クラスは、カスタムフォーマッタを作成するときに使用できるユーティリティクラスです。 このクラスは、あるストリングのプレースホルダー文字を別のストリングの数値に置き換える処理を行います。

たとえば、SwitchSymbolFormatter クラスに次の情報を指定します。

フォーマットストリング: "The SocialSecurity number is: ###-##-####"

入力ストリング: "123456789"

SwitchSymbolFormatter クラスは、フォーマットストリングを解析して、各プレースホルダー文字(デフォルト "#")を入力ストリングの数字に置換します。なお、入力ストリングの数字は、入力ストリングで指定されている順番で挿入されます。 別のプレースホルダー記号を定義するには、SwitchSymbolFormatter オブジェクトをインスタンス化する際に、コンストラクタにその記号を渡します。

SwitchSymbolFormatter クラスでこれらの 2 つのストリングから作成される出力ストリングは、次のようになります。

"The SocialSecurity number is: 123-45-6789"

パターンには、ストリングの数値の部分の値の定数を表す任意の文字を指定できます ただし、フォーマットする値は数値である必要があります。

ソース値で指定する桁数は、パターンストリングで定義されている桁数と一致する必要があります。 SwitchSymbolFormatter オブジェクトを呼び出すスクリプトでは、このことに注意してください。

例を表示

関連項目

mx.formatters.PhoneFormatter
Using the SwitchSymbolFormatter class


パブリックプロパティ
 プロパティ定義元
 Inheritedconstructor : Object
指定されたオブジェクトインスタンスのクラスオブジェクトまたはコンストラクタ関数への参照です。
Object
 Inheritedprototype : Object
[静的] クラスまたは関数オブジェクトのプロトタイプオブジェクトへの参照です。
Object
パブリックメソッド
 メソッド定義元
  
SwitchSymbolFormatter(numberSymbol:String = "#")
コンストラクタです。
SwitchSymbolFormatter
  
フォーマットパターンを使用してソースストリングをフォーマットすることによって、新しいストリングを作成します。
SwitchSymbolFormatter
 Inherited
オブジェクトに指定されたプロパティが定義されているかどうかを示します。
Object
 Inherited
Object クラスのインスタンスが、パラメータとして指定されたオブジェクトのプロトタイプチェーン内にあるかどうかを示します。
Object
 Inherited
指定されたプロパティが存在し、列挙できるかどうかを示します。
Object
 Inherited
ループ処理に対するダイナミックプロパティの可用性を設定します。
Object
 Inherited
指定されたオブジェクトのストリング表現を返します。
Object
 Inherited
指定されたオブジェクトのプリミティブな値を返します。
Object
コンストラクタの詳細
SwitchSymbolFormatter()コンストラクタ
public function SwitchSymbolFormatter(numberSymbol:String = "#")

コンストラクタです。

パラメータ
numberSymbol:String (default = "#") — パターン文字として使用する文字を表します。
メソッドの詳細
formatValue()メソッド
public function formatValue(format:String, source:Object):String

フォーマットパターンを使用してソースストリングをフォーマットすることによって、新しいストリングを作成します。

パラメータ

format:String — ユーザーが要求したパターン追加を定義するストリングを表します。
 
source:Object — 有効な数値並びを表します。必要に応じてアルファ文字を使用できます。

戻り値
String
例の使用法
SwitchSymbolFormatterExample.mxml
<?xml version="1.0" encoding="utf-8"?>
<!-- Simple example to demonstrate SwitchSymbolFormatter. -->
<mx:Application xmlns:mx="http://www.adobe.com/2006/mxml">

    <mx:Script>
        <![CDATA[
        
            import mx.formatters.SwitchSymbolFormatter;                
            import mx.events.ValidationResultEvent;            
            
            private var vResult:ValidationResultEvent;

            // Event handler to validate and format input.            
            private function Format():void
            {
                vResult = scVal.validate();

                if (vResult.type==ValidationResultEvent.VALID) {
                    var switcher:SwitchSymbolFormatter=new SwitchSymbolFormatter('#');

                    formattedSCNumber.text = 
                        switcher.formatValue("Formatted Social Securty number: ###-##-#### ", scNum.text);
                }

                else {
                    formattedSCNumber.text= "";
                }
            }
        ]]>
    </mx:Script>

    <mx:SocialSecurityValidator id="scVal" source="{scNum}" property="text"/>

    <mx:Panel title="SwitchSymbolFormatter Example" width="75%" height="75%" 
            paddingTop="10" paddingLeft="10" paddingRight="10" paddingBottom="10">

        <mx:Label text="Enter a 9 digit Social Security number with no separator characters:"/>
        <mx:TextInput id="scNum" text="" maxChars="9" width="50%"/>

        <mx:Button label="Validate and Format" click="Format();"/>
        <mx:TextInput id="formattedSCNumber" editable="false" width="75%"/>

    </mx:Panel>
</mx:Application>




 

 

このページに新しいコメントが追加された場合に、電子メールでの通知を希望する。 | コメントレポート

現在のページ: http://livedocs.adobe.com/flex/3_jp/langref/mx/formatters/SwitchSymbolFormatter.html