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

MatchingCollator  - AS3 Flex

パッケージspark.globalization
クラスpublic class MatchingCollator
継承MatchingCollator Inheritance CollatorBase Inheritance GlobalizationBase Inheritance AdvancedStyleClient Inheritance EventDispatcher Inheritance Object

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

MatchingCollator クラスは、テキストのブロックから一致する単語を検索するなどの汎用のストリング照合に適した初期設定を使用して、ロケールに依存したストリングの比較機能を提供します。

このクラスは flash.globalization.Collator のラッパークラスです。したがって、ロケール固有のストリングの比較が flash.globalization.Collator によって提供されます。 ただし、この MatchingCollator クラスは MXML 宣言で使用でき、要求されたロケール ID 名にロケールスタイルを使用し、バインド可能なメソッドおよびプロパティを持ちます。 また、flash.globalization クラスによってエラーまたは警告が生成される場合は、LastOperationStatus が設定されます。

flash.globalization.Collator クラスでは、フォーマット機能と、ロケール固有データの提供用に、基盤となるオペレーティングシステムを使用します。 一部のオペレーティングシステムでは、flash.globalization クラスがサポートされておらず、このラッパークラスが代替機能を提供します。

例を表示

さらに例を参照

関連する API エレメント



パブリックプロパティ
 プロパティ定義元
 InheritedactualLocaleIDName : String
[オーバーライド] [読み取り専用] このクラスオブジェクトで使用される実際のロケール ID の名前。
CollatorBase
 InheritedclassName : String
[読み取り専用] コンポーネントクラスの名前です。
AdvancedStyleClient
 Inheritedconstructor : Object
指定されたオブジェクトインスタンスのクラスオブジェクトまたはコンストラクター関数への参照です。
Object
 Inheritedid : String
コンポーネントの ID です。
AdvancedStyleClient
 InheritedignoreCase : Boolean
このプロパティが true に設定されている場合、同一のストリングおよび大文字と小文字の区別だけが違うストリングが、等しいストリングとして評価されます。
CollatorBase
 InheritedignoreCharacterWidth : Boolean
このプロパティが true に設定されている場合、一部の中国語および日本語の文字の全角と半角の形が、等しい形として評価されます。
CollatorBase
 InheritedignoreDiacritics : Boolean
このプロパティが true に設定されている場合、ストリングで使用されている基本文字が同じであれば、アクセントやその他の識別記号の違いがあっても、同じストリングと評価されます。
CollatorBase
 InheritedignoreKanaType : Boolean
このプロパティが true に設定されている場合、カナ文字の種類のみが異なる文字列は、等しい文字列として扱われます。
CollatorBase
 InheritedignoreSymbols : Boolean
このプロパティが true に設定されている場合、スペース、通貨記号、数学記号およびその他の種類の記号などの記号文字はソート時または照合時に無視されます。
CollatorBase
 InheritedinheritingStyles : Object
このビジュアルでないスタイルクライアントのインスタンスの継承可能なスタイルを含むオブジェクトです。
AdvancedStyleClient
 InheritedlastOperationStatus : String
[オーバーライド] [読み取り専用] このクラスオブジェクトが実行した最新の操作のステータス。
CollatorBase
 InheritedmoduleFactory : IFlexModuleFactory
モジュールファクトリは、このビジュアルでないスタイルクライアントのインスタンスのスタイルを制御するスタイルマネージャーを検索するためのコンテキストとして使用されます。
AdvancedStyleClient
 InheritednonInheritingStyles : Object
このコンポーネントの非継承スタイルのチェーンの始まりです。
AdvancedStyleClient
 InheritednumericComparison : Boolean
ストリングに埋め込まれた数値の、ストリングの比較時の取扱方法を制御します。
CollatorBase
 InheritedstyleDeclaration : CSSStyleDeclaration
このオブジェクトで宣言されたインラインスタイルを保持するスタイル宣言です。
AdvancedStyleClient
 InheritedstyleManager : IStyleManager2
[読み取り専用] このコンポーネントで使用する StyleManager インスタンスを返します。
AdvancedStyleClient
 InheritedstyleName : Object
オブジェクトのスタイル値のソースです。
AdvancedStyleClient
 InheritedstyleParent : IAdvancedStyleClient
コンポーネントの親は、下位要素のセレクターを評価するために使用されます。
AdvancedStyleClient
パブリックメソッド
 メソッド定義元
  
指定されたロケールの規則に従ってストリング比較を提供する新しい MatchingCollator オブジェクトを作成します。
MatchingCollator
 Inherited
addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void
イベントリスナーオブジェクトを EventDispatcher オブジェクトに登録し、リスナーがイベントの通知を受け取るようにします。
EventDispatcher
 Inherited
このコンポーネントインスタンスからスタイルプロパティを削除します。
AdvancedStyleClient
 Inherited
compare(string1:String, string2:String):int
2 つの文字列を比較して、1 番目の文字列が 2 番目の文字列と比べて小さいか、等しいか、大きいかを示す整数値を返します。
CollatorBase
 Inherited
イベントをイベントフローに送出します。
EventDispatcher
 Inherited
equals(string1:String, string2:String):Boolean
2 つの文字列を比較して、文字列が等しいかどうかを示すブール値を返します。
CollatorBase
 Inherited
[静的] このクラスでサポートされているすべてのロケール ID 名のリストが表示されます。
CollatorBase
 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
コンストラクターの詳細

MatchingCollator

()コンストラクター
public function MatchingCollator()

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

指定されたロケールの規則に従ってストリング比較を提供する新しい MatchingCollator オブジェクトを作成します。

このクラスは、2 つのストリングが同等かどうかを判別したり、テキストのブロックから一致する単語を検索したりするなどの汎用のストリング照合で使用する様々な照合用の初期値を設定します。 このモードでは、ストリングの比較を行うときに、大文字と小文字の違い、アクセント付き文字などが無視されます。

このクラスのインスタンスによって提供される比較は、initialMode パラメーターを CollatorMode.MATCHING に設定して flash.globalization.Collator のインスタンスを作成するのと同等です。 このモードの詳細および例については、flash.globalization.Collator クラスのマニュアルを参照してください。

このクラスのロケールはロケールスタイルによって提供されます。 ロケールスタイルは、次のいくつかの方法で設定できます。

  • UIComponent の addStyleClient メソッドを呼び出すことによって UIComponent からスタイルを継承する。
  • MXML 宣言内でクラスを使用し、宣言を格納するドキュメントからロケールを継承する。
          Example:
          <fx:Declarations>
                 <s:MatchingCollator id="mc" />
          </fx:Declarations>
          
  • MXML 宣言を使用し、代入のリスト内でロケールの値を指定する。
          Example:
          <fx:Declarations>
              <s:MatchingCollator id="mc_France" locale="fr-FR" />
          </fx:Declarations>
          
  • setStyle メソッド(mc.setStyle("locale", "fr-FR") など)を呼び出す。

locale スタイルが上記のいずれかの手法で設定されていない場合は、このクラスのインスタンスが StyleClient として topLevelApplication に追加されるため、locale 依存のプロパティ getter または locale 依存のメソッドが呼び出されるときに、topLevelApplication オブジェクトから locale が継承されます。

関連する API エレメント

MatchingCollatorExample.mxml
<?xml version="1.0" encoding="utf-8"?>
<!-- Sample program for spark.globalization.MatchingCollator -->
<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:Declarations>
        <s:MatchingCollator id="collator"/>
    </fx:Declarations>

    <fx:Script>
        <![CDATA[
            import mx.collections.ArrayCollection;
            import mx.events.ListEvent;

            private static const localeList:ArrayCollection
                = new ArrayCollection([
                    { label:"English (en)", data:"en" },
                    { label:"Turkish (tr)", data:"tr" } ]);

            private static const wordList:ArrayCollection
                = new ArrayCollection([
                    "Windows", "windows", "WINDOWS",
                    "Wındows", "wındows", "WİNDOWS" ]);

            private function inputWord_changeHandler(event:Event):void
            {
                const word:String = inputWord.selectedItem as String;
                resultWordList.text = "";
                for (var i:int = 0; i < wordList.length; ++i)
                {
                    if (collator.equals(word, wordList[i]))
                        resultWordList.text += wordList[i] + " ";
                }
            }
        ]]>
    </fx:Script>

    <mx:Form>
        <mx:FormItem label="Select Language">
            <mx:ComboBox id="localeSelector"
                change="setStyle('locale', localeSelector.selectedItem.data);"
                dataProvider="{localeList}"/>
        </mx:FormItem>
        <mx:FormItem label="Ignore case">
            <s:CheckBox id="ignoreCase" selected="{collator.ignoreCase}"
                change="collator.ignoreCase = ignoreCase.selected"/>
        </mx:FormItem>
        <mx:FormItem label="Input word">
            <mx:ComboBox id="inputWord" dataProvider="{wordList}"/>
            <s:Button click="inputWord_changeHandler(event)" label="Find"/>
        </mx:FormItem>
        <mx:FormItem label="Result Matching Words">
            <mx:Text id="resultWordList"/>
        </mx:FormItem>
    </mx:Form>
</s:Application>




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

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