SwitchSymbolFormatter

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

言語バージョン:

ActionScript 3.0

製品バージョン:

Flex 3

ランタイムバージョン:

Flash Player 9, AIR 1.1

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

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

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

入力ストリング： "123456789"

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

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

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

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

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

例を表示

さらに例を参照

Using the SwitchSymbolFormatter class

関連する API エレメント

mx.formatters.PhoneFormatter

パブリックプロパティ

継承されるパブリックプロパティを隠す

継承されるパブリックプロパティを表示

	プロパティ		定義元
		constructor : Object 指定されたオブジェクトインスタンスのクラスオブジェクトまたはコンストラクター関数への参照です。	Object

パブリックメソッド

継承されるパブリックメソッドを隠す

継承されるパブリックメソッドを表示

	メソッド		定義元
		SwitchSymbolFormatter(numberSymbol:String = "#") コンストラクターです。	SwitchSymbolFormatter
		formatValue(format:String, source:Object):String フォーマットパターンを使用してソースストリングをフォーマットすることによって、新しいストリングを作成します。	SwitchSymbolFormatter
		hasOwnProperty(name:String):Boolean オブジェクトに指定されたプロパティが定義されているかどうかを示します。	Object
		isPrototypeOf(theClass:Object):Boolean Object クラスのインスタンスが、パラメーターとして指定されたオブジェクトのプロトタイプチェーン内にあるかどうかを示します。	Object
		propertyIsEnumerable(name:String):Boolean 指定されたプロパティが存在し、列挙できるかどうかを示します。	Object
		setPropertyIsEnumerable(name:String, isEnum:Boolean = true):void ループ処理に対するダイナミックプロパティの可用性を設定します。	Object
		toLocaleString():String ロケール固有の規則に従って書式設定された、このオブジェクトのストリング表現を返します。	Object
		toString():String 指定されたオブジェクトのストリング表現を返します。	Object
		valueOf():Object 指定されたオブジェクトのプリミティブな値を返します。	Object

コンストラクターの詳細

()

コンストラクター

public function SwitchSymbolFormatter(numberSymbol:String = "#")

言語バージョン:

ActionScript 3.0

製品バージョン:

Flex 3

ランタイムバージョン:

Flash Player 9, AIR 1.1

コンストラクターです。

パラメーター

numberSymbol:String (default = "#") — パターン文字として使用する文字を表します。

メソッドの詳細

formatValue

()

メソッド

public function formatValue(format:String, source:Object):String

言語バージョン:

ActionScript 3.0

製品バージョン:

Flex 3

ランタイムバージョン:

Flash Player 9, AIR 1.1

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

パラメーター

	`format:String` — ユーザーが要求したパターン追加を定義するストリングを表します。

	`source:Object` — 有効な数値並びを表します。必要に応じてアルファ文字を使用できます。

戻り値

String — フォーマットしたストリングを表します。

例この例の使用方法

SwitchSymbolFormatterExample.mxml

<?xml version="1.0" encoding="utf-8"?>
<!-- Simple example to demonstrate SwitchSymbolFormatter. -->
<s:Application xmlns:fx="http://ns.adobe.com/mxml/2009"
        xmlns:s="library://ns.adobe.com/flex/spark"
        xmlns:mx="library://ns.adobe.com/flex/mx">

    <fx: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= "";
                }
            }
        ]]>
    </fx:Script>

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

    <s:Panel title="SwitchSymbolFormatter Example"
            width="75%" height="75%"
            horizontalCenter="0" verticalCenter="0">
        <s:VGroup left="10" right="10" top="10" bottom="10">
            <s:Label text="Enter a 9 digit Social Security number with no separator characters:" />
            <s:TextInput id="scNum" text="" maxChars="9" width="50%" />

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

</s:Application>

法律上の注意 | プライバシーポリシー

SwitchSymbolFormatter - AS3 Flex

クラス x

SwitchSymbolFormatter

formatValue