IResourceManager  - AS3 Flex

リソースに対する検索で検索対象の 1 つまたは複数のロケールを指定する、[ "en_US" ] などのロケールストリングの配列です。

ResourceManager の getObject()、getString()、getStringArray()、getNumber()、getInt()、getUint()、getBoolean()、getClass() のいずれかのメソッドを呼び出してリソースの値を取得する場合、バンドル名とリソース名を指定しますが、ロケールは指定しません。 ResourceManager は、localeChain 内の最初のロケールから順に、そのロケールの指定されたバンドル名を持つ ResourceBundle を検索します。 該当する ResourceBundle が存在し、その中に指定されたリソースが存在する場合、そのリソースの値が返されます。 それ以外の場合は、localeChain 内の別のロケールに検索が進みます。

このような方法でリソースが検索されるので、ローカライズされたリソースの完全なセットがロケールに含まれていなくてもかまいません。 例えば、米国英語ではなくインド英語用にアプリケーションをローカライズする場合は、米国英語とはスペルまたは用法が異なる en_IN ロケール用のリソースのみを提供し、localeChain プロパティを [ "en_IN", "en_US" ] に設定するだけで済みます。

多くのフレームワーククラスは、いくつかのロケールから必要なリソースを常に取得可能であることを前提としており、取得できない場合はエラーをスローします。 したがって、リソースの完全なセットが localeChain に常に含まれるようにする必要があります。 独自のアプリケーションのリソースを含む、フレームワークのすべてのリソースのローカライズが完了していない場合は、"en_US" ロケールを localeChain の末尾に保持しておくことにより、必要なリソースを取得できます。

このプロパティを設定すると、ResourceManager によって "change" イベントが送出されます。

指定された ResourceBundle が ResourceManager に追加され、getString() などの ResourceManager メソッドでそのリソースにアクセスできるようになります。

パラメーター

指定されたリソースの localeChain 内のロケールを検索し、最初に検出したリソースバンドルを返します。 リソースが見つからなかった場合、このメソッドは null を返します。

パラメーター

ブール型として指定されているリソースの値を取得します。

このメソッドは最初に getString() を呼び出し、結果を小文字に変換します。 次に、結果が "true" であった場合は true を返します。 それ以外の場合は false を返します。

指定されたリソースが見つからない場合、このメソッドは false を返します。

パラメーター

ResourceManager に存在し、指定されたロケールに属するすべての ResourceBundle オブジェクトのバンドル名を指定するストリングの配列を返します。

この配列内でのバンドル名の順序は決まっていません。

パラメーター

関連する API エレメント

クラスとして指定されているリソースの値を取得します。

このメソッドは getObject() を呼び出し、as 演算子を使用して値をクラス型に強制的に変換します。 リソース値がクラス参照でなかった場合、結果は null になります。 このメソッドは、.properties ファイルに次のような行が書き込まれていて、

      IMAGE=Embed("image.jpg")
      BUTTON_SKIN=ClassReference("skins.ButtonSkin_en_US")
      

Embed() ディレクティブまたは ClassReference() ディレクティブで作成されたクラスを取得する場合に役立ちます。

指定されたリソースが見つからない場合、このメソッドは null を返します。

パラメーター

指定されたリソースの値を int として取得します。

このメソッドは getObject() を呼び出し、結果を int にキャストします。このメソッドは、プロパティファイル内に次のような行があり、

      MINIMUM=5
      

5 という値（"5" ではなく）を取得する場合に役立ちます。

指定されたリソースが見つからない場合、このメソッドは 0 を返します。

パラメーター

ResourceManager に存在する ResourceBundle オブジェクトのすべてのロケールを指定するストリングの配列を返します。

この配列内でのロケールの順序は決まっていません。

数値として指定されているリソースの値を取得します。

このメソッドは getObject() を呼び出し、結果を数値にキャストします。 このメソッドは、プロパティファイル内に次のような行があり、

      LONGITUDE=170.3
      

プロパティファイル内にこのような行があり、170.3 という値（"170.3" ではなく）を取得する場合に役立ちます。

指定されたリソースが見つからない場合、このメソッドは NaN を返します。

パラメーター

オブジェクトとして指定されているリソースの値を取得します。

ResourceBundle の content オブジェクトに格納されているそのままの状態の値を、変換せずに返します。 リソースがプロパティファイルからコンパイルされた場合、content オブジェクトのリソース値は常にストリングです。ただし、Embed() ディレクティブまたは ClassReference() ディレクティブを使用した場合、リソース値はクラスになります。 getString()、getStringArray()、getNumber()、getInt()、getUint()、getBoolean()、getClass() の各メソッドを使用して、値をより具体的な型に変換します。

指定されたリソースが見つからない場合、このメソッドは undefined を返します。

パラメーター

Capabilities.language または Capabilities.languages により報告されたように、ユーザー環境設定を使用して順序付けられた、ResourceManager に存在する ResourceBundle オブジェクトのすべてのロケールを指定するストリングの配列を返します。

指定された locale と bundleName を持つ ResourceBundle（以前に addResourceBundle() を使用して ResourceManager に追加されたもの）を返します。 該当する ResourceBundle がない場合、このメソッドは null を返します。

パラメーター

関連する API エレメント

ストリングとして指定されたリソースの値を、プレースホルダーを指定された値に置き換えた後で取得します。

このメソッドは getObject() を呼び出し、結果をストリングにキャストします。

parameters 配列をこのメソッドに渡すと、配列の中のパラメーターがストリングに変換され、プレースホルダー（"{0}" や "{1}" など）がそれらのストリングに順番どおりに置き換えられた後、結果のストリングが返されます。

指定されたリソースが見つからない場合、このメソッドは null を返します。

パラメーター

ストリングの配列として指定されているリソースの値を取得します。

このメソッドは、カンマで区切られた項目のリストが格納されたストリングをリソース値と見なします。 このメソッドは、getString() メソッドを呼び出し、ストリングをカンマの位置で項目に分割して、各項目の前後にある空白を除去します。 このメソッドは、プロパティファイル内に次のような行があり、

      COUNTRIES=India, China, Japan
      

[ "India", "China", "Japan" ] という値（"India, China, Japan" という値ではなく）を取得する場合に役立ちます。

指定されたリソースが見つからない場合、このメソッドは null を返します。

パラメーター

指定されたリソースの値を uint として取得します。

このメソッドは getObject() メソッドを呼び出し、結果を uint にキャストします。 このメソッドは、プロパティファイル内に次のような行があり、

      MINIMUM=5
      

5 という値（"5" ではなく）を取得する場合に役立ちます。

指定されたリソースが見つからない場合、このメソッドは 0 を返します。

パラメーター

オペレーティングシステムのユーザー推奨ロケールを SWF の使用可能なロケールのリストと比較するアルゴリズムを使用して、ResourceManager の localeChain プロパティを初期化します。

例えば、ユーザーがオペレーティングシステムでフランス語を使用するように指定していた場合に、SWF が en_US、fr_FR および de_DE のロケールでコンパイルされた場合は、localeChain の最初のロケールが fr_FR になるように設定されます。

このメソッドは、IFlexModuleFactory インターフェイスを実装するクラスのみによって使用されます。

パラメーター

関連する API エレメント

SWF にコンパイルされたすべての ResourceBundle サブクラスのインスタンスを作成して、ResourceManager に追加します。

例えば、locales パラメーターが [ "en_US", "ja_JP" ] で、bundleNames パラメーターが [ "core", "controls" ] の場合は、4 つのリソースバンドルがインストールされます。

このメソッドは、IFlexModuleFactory インターフェイスを実装するクラスのみによって使用されます。

パラメーター

関連する API エレメント

リソースバンドルを含むリソースモジュールのロードを開始します。

このメソッドを呼び出すたびに、新しいイベント送出オブジェクトが返されます。そのオブジェクトを使用すると、ロードの進捗状況およびロードが正常に完了したかまたはエラーが発生したかを確認できます。 このオブジェクトは、ResourceEvent.PROGRESS、ResourceEvent.COMPLETE、ResourceEvent.ERROR の各イベントを送出します。

モジュールがロードされると、リソースバンドルが ResourceManager に追加されますが、localeChain は変更されません。 update パラメーターが true の場合、update() メソッドが呼び出されます。

パラメーター

関連する API エレメント

指定された ResourceBundle が ResourceManager から削除され、getString() などの ResourceManager メソッドでそのリソースにアクセスできなくなります。

パラメーター

関連する API エレメント

指定されたロケールのすべての ResourceBundle が ResourceManager から削除され、getString() などの ResourceManager メソッドでそのリソースにアクセスできなくなります。

パラメーター

関連する API エレメント

ロード済みのリソースモジュールのアンロードを開始します。

モジュールがアンロードされると、そのリソースバンドルは ResourceManager から削除されますが、localeChain は変更されません。update パラメーターが true の場合、update() メソッドが呼び出されます。

パラメーター

ResourceManager から change イベントを送出します。

これにより、バインディング式に ResourceManager メソッドの getObject()、getString()、getStringArray()、getNumber()、getInt()、getUint()、getBoolean()、getClass() のいずれかが含まれる場合に、それらのバインディング式が再評価されます。

また、UIComponent、Formatter または Validator の resourcesChanged() メソッドも実行されます。 多くのコンポーネントがこのメソッドを実装し、最新のリソースに基づいてその状態を更新します。