パッケージ | mx.resources |
インターフェイス | public interface IResourceManager extends IEventDispatcher |
言語バージョン: | ActionScript 3.0 |
製品バージョン: | Flex 3 |
ランタイムバージョン: | Flash Player 9, AIR 1.1 |
ローカライズには、ロケール、リソースおよびリソースバンドルの 3 つの主要な概念が関係します。
ロケールは、アプリケーションをローカライズした後の言語と国を指定します。 たとえば、ロケール "en_US"
は、米国で使用される英語を指定します。 詳細については、mx.resources.Locale クラスを参照してください。
リソースは、ロケールに依存した名前付きの値です。 たとえば、アプリケーションに "OPEN"
という名前のリソースがある場合、英語ロケールでのそのリソースの値は "Open"
です。一方、フランス語ロケールの場合、値は "Ouvrir"
です。
リソースバンドルは、値が特定のロケール用にローカライズされたリソースの、名前付きのグループです。 リソースバンドルは、bundleName
と locale
の組み合わせによって識別され、バンドルのリソースの名前と値のペアを含む content
オブジェクトを持っています。 プロパティファイルからリソースバンドルを作成する一般的な方法については、mx.resources.IResourceBundle のドキュメントを参照してください。
IResourceManager インタフェースを実装した単一の ResourceManager オブジェクトは、(場合によっては複数のロケールの)複数のリソースバンドルを管理し、リソースバンドルに含まれるリソースへのアクセスを提供します。 例えば、resourceManager.getString(bundleName, resourceName)
を呼び出すことにより、特定のリソースをストリングとして取得できます。
UIComponent、Formatter または Validator を拡張するクラスはすべて、このインタフェースを実装するオブジェクトへの参照を提供する resourceManager
プロパティを持っています。 それ以外のクラスは、ResourceManager.getInstance()
を呼び出すことでこのオブジェクトを取得できます。
リソースを取得する getString()
などのメソッドは、localeChain
プロパティに指定されたロケールのリソースを検索します。 このプロパティを変更すると、例えばアプリケーションで使用している英語リソースを、即座に日本語リソースに切り替えることができます。
アプリケーションを起動すると、アプリケーションにコンパイルされたリソースバンドルを使用して、ResourceManager が自動的に設定されます。 コードモジュールを作成すると、クラスに必要なリソースがデフォルトでモジュールにコンパイルされます。 モジュールがアプリケーションにロードされると、まだアプリケーションにないバンドルが ResourceManager に追加されます。
リソースのみを持つ "リソースモジュール" をコンパイルし、IResourceManager の loadResourceModule()
メソッドを使用してそれらをロードできます。リソースモジュールを使用すると、リソースをアプリケーションにコンパイルする代わりに、実行時に必要なリソースをロードして複数のロケールをサポートできます。
通常、ResourceManager は、アプリケーションにコンパイルされているかモジュールからロードしたリソースバンドルを使用して設定されますが、プログラムでリソースバンドルを作成し、addResourceBundle()
メソッドを使用して ResourceManager に追加することもできます。
関連する API エレメント
プロパティ | 定義元 | ||
---|---|---|---|
localeChain : Array
リソースに対する検索で検索対象の 1 つまたは複数のロケールを指定する、[ "en_US" ] などのロケールストリングの配列です。 | IResourceManager |
メソッド | 定義元 | ||
---|---|---|---|
addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void
イベントリスナーオブジェクトを EventDispatcher オブジェクトに登録し、リスナーがイベントの通知を受け取るようにします。 | IEventDispatcher | ||
指定された ResourceBundle が ResourceManager に追加され、getString() などの ResourceManager メソッドでそのリソースにアクセスできるようになります。 | IResourceManager | ||
イベントをイベントフローに送出します。 | IEventDispatcher | ||
指定されたリソースの localeChain 内のロケールを検索し、最初に検出したリソースバンドルを返します。 | IResourceManager | ||
ブール型として指定されているリソースの値を取得します。 | IResourceManager | ||
ResourceManager に存在し、指定されたロケールに属するすべての ResourceBundle オブジェクトのバンドル名を指定するストリングの配列を返します。 | IResourceManager | ||
クラスとして指定されているリソースの値を取得します。 | IResourceManager | ||
指定されたリソースの値を int として取得します。 | IResourceManager | ||
ResourceManager に存在する ResourceBundle オブジェクトのすべてのロケールを指定するストリングの配列を返します。 | IResourceManager | ||
数値として指定されているリソースの値を取得します。 | IResourceManager | ||
オブジェクトとして指定されているリソースの値を取得します。 | IResourceManager | ||
Capabilities.language または Capabilities.languages により報告されたように、ユーザー環境設定を使用して順序付けられた、ResourceManager に存在する ResourceBundle オブジェクトのすべてのロケールを指定するストリングの配列を返します。 | IResourceManager | ||
以前に addResourceBundle() を使用して ResourceManager に追加された、指定された locale と bundleName を持つ ResourceBundle を返します。 | IResourceManager | ||
getString(bundleName:String, resourceName:String, parameters:Array = null, locale:String = null):String
ストリングとして指定されたリソースの値を、プレースホルダーを指定された値に置き換えた後で取得します。 | IResourceManager | ||
ストリングの配列として指定されているリソースの値を取得します。 | IResourceManager | ||
指定されたリソースの値を uint として取得します。 | IResourceManager | ||
EventDispatcher オブジェクトに、特定のイベントタイプに対して登録されたリスナーがあるかどうかを確認します。 | IEventDispatcher | ||
オペレーティングシステムのユーザー推奨ロケールを SWF の使用可能なロケールのリストと比較するアルゴリズムを使用して、ResourceManager の localeChain プロパティを初期化します。 | IResourceManager | ||
installCompiledResourceBundles(applicationDomain:ApplicationDomain, locales:Array, bundleNames:Array, useWeakReference:Boolean = false):Array
SWF にコンパイルされたすべての ResourceBundle サブクラスのインスタンスを作成して、ResourceManager に追加します。 | IResourceManager | ||
loadResourceModule(url:String, update:Boolean = true, applicationDomain:ApplicationDomain = null, securityDomain:SecurityDomain = null):IEventDispatcher
リソースバンドルを含むリソースモジュールのロードを開始します。 | IResourceManager | ||
EventDispatcher オブジェクトからリスナーを削除します。 | IEventDispatcher | ||
指定された ResourceBundle が ResourceManager から削除され、getString() などの ResourceManager メソッドでそのリソースにアクセスできなくなります。 | IResourceManager | ||
指定されたロケールのすべての ResourceBundle が ResourceManager から削除され、getString() などの ResourceManager メソッドでそのリソースにアクセスできなくなります。 | IResourceManager | ||
ロード済みのリソースモジュールのアンロードを開始します。 | IResourceManager | ||
ResourceManager から change イベントを送出します。 | IResourceManager | ||
指定されたイベントタイプについて、この EventDispatcher オブジェクトまたはその祖先にイベントリスナーが登録されているかどうかを確認します。 | IEventDispatcher |
localeChain | プロパティ |
localeChain:Array
言語バージョン: | ActionScript 3.0 |
製品バージョン: | Flex 3 |
ランタイムバージョン: | Flash Player 9, AIR 1.1 |
リソースに対する検索で検索対象の 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"
イベントが送出されます。
実装
public function get localeChain():Array
public function set localeChain(value:Array):void
addResourceBundle | () | メソッド |
public function addResourceBundle(resourceBundle:IResourceBundle, useWeakReference:Boolean = false):void
言語バージョン: | ActionScript 3.0 |
製品バージョン: | Flex 3 |
ランタイムバージョン: | Flash Player 9, AIR 1.1 |
指定された ResourceBundle が ResourceManager に追加され、getString()
などの ResourceManager メソッドでそのリソースにアクセスできるようになります。
パラメーター
resourceBundle:IResourceBundle — 追加するリソースバンドルです。
| |
useWeakReference:Boolean (default = false ) — ResourceManager でリソースバンドルへの弱参照を維持するかどうかを決定します。useWeakReference を true にした場合、ResourceManager でリソースバンドルへの弱参照が提供されます。呼び出し側で弱参照の使用を選択した場合、呼び出し側でリソースバンドルへの強参照を維持し、リソースバンドルが早期にガベージコレクションされないようにする必要があります。useWeakReference を false にした場合、ResourceManager でリソースバンドルへの強参照が維持され、リソースバンドルはガベージコレクションされません。
Flex サブアプリケーションまたはモジュールでコンパイル済みのリソースバンドルを ResourceManager に自動的に追加する場合は、メモリ内で位置が固定化されないように、 |
findResourceBundleWithResource | () | メソッド |
public function findResourceBundleWithResource(bundleName:String, resourceName:String):IResourceBundle
言語バージョン: | ActionScript 3.0 |
製品バージョン: | Flex 3 |
ランタイムバージョン: | Flash Player 9, AIR 1.1 |
指定されたリソースの localeChain
内のロケールを検索し、最初に検出したリソースバンドルを返します。 リソースが見つからなかった場合、このメソッドは null
を返します。
パラメーター
bundleName:String — "MyResources" などのバンドル名です。
| |
resourceName:String — リソースバンドルのリソースの名前です。
|
IResourceBundle — 指定されたリソースが含まれた localeChain 内の最初の ResourceBundle、または null です。
|
getBoolean | () | メソッド |
public function getBoolean(bundleName:String, resourceName:String, locale:String = null):Boolean
言語バージョン: | ActionScript 3.0 |
製品バージョン: | Flex 3 |
ランタイムバージョン: | Flash Player 9, AIR 1.1 |
ブール型として指定されているリソースの値を取得します。
このメソッドは最初に getString()
を呼び出し、結果を小文字に変換します。 次に、結果が "true"
であった場合は true
を返します。 それ以外の場合は false
を返します。
指定されたリソースが見つからない場合、このメソッドは false
を返します。
パラメーター
bundleName:String — リソースバンドルの名前です。
| |
resourceName:String — リソースバンドルのリソースの名前です。
| |
locale:String (default = null ) — 参照に使用する特定のロケールです。null の場合は、localeChain 内のすべてのロケールを検索します。 このパラメーターはオプションであり、デフォルトは null です。このパラメーターの指定が必要になることはほとんどありません。
|
Boolean — ブール値としてのリソース値、または、リソースが見つからない場合は false です。
|
getBundleNamesForLocale | () | メソッド |
public function getBundleNamesForLocale(locale:String):Array
言語バージョン: | ActionScript 3.0 |
製品バージョン: | Flex 3 |
ランタイムバージョン: | Flash Player 9, AIR 1.1 |
ResourceManager に存在し、指定されたロケールに属するすべての ResourceBundle オブジェクトのバンドル名を指定するストリングの配列を返します。
この配列内でのバンドル名の順序は決まっていません。
パラメーター
locale:String — "en_US" などのロケールストリングです。
|
Array — バンドル名の配列です。
|
関連する API エレメント
getClass | () | メソッド |
public function getClass(bundleName:String, resourceName:String, locale:String = null):Class
言語バージョン: | ActionScript 3.0 |
製品バージョン: | Flex 3 |
ランタイムバージョン: | Flash Player 9, AIR 1.1 |
クラスとして指定されているリソースの値を取得します。
このメソッドは getObject()
を呼び出し、as
演算子を使用して値をクラス型に強制的に変換します。 リソース値がクラス参照でなかった場合、結果は null
になります。 このメソッドは、.properties ファイルに次のような行が書き込まれていて、
IMAGE=Embed("image.jpg") BUTTON_SKIN=ClassReference("skins.ButtonSkin_en_US")
Embed()
ディレクティブまたは ClassReference()
ディレクティブで作成されたクラスを取得する場合に役立ちます。
指定されたリソースが見つからない場合、このメソッドは null
を返します。
パラメーター
bundleName:String — リソースバンドルの名前です。
| |
resourceName:String — リソースバンドルのリソースの名前です。
| |
locale:String (default = null ) — 参照に使用する特定のロケールです。null の場合は、localeChain 内のすべてのロケールを検索します。 このパラメーターはオプションであり、デフォルトは null です。このパラメーターの指定が必要になることはほとんどありません。
|
Class — Class としてのリソース値、または、リソースが見つからない場合は null です。
|
getInt | () | メソッド |
public function getInt(bundleName:String, resourceName:String, locale:String = null):int
言語バージョン: | ActionScript 3.0 |
製品バージョン: | Flex 3 |
ランタイムバージョン: | Flash Player 9, AIR 1.1 |
指定されたリソースの値を int として取得します。
このメソッドは getObject()
を呼び出し、結果を int にキャストします。このメソッドは、プロパティファイル内に次のような行があり、
MINIMUM=5
5 という値("5"
ではなく)を取得する場合に役立ちます。
指定されたリソースが見つからない場合、このメソッドは 0 を返します。
パラメーター
bundleName:String — リソースバンドルの名前です。
| |
resourceName:String — リソースバンドルのリソースの名前です。
| |
locale:String (default = null ) — 参照に使用する特定のロケールです。null の場合は、localeChain 内のすべてのロケールを検索します。 このパラメーターはオプションであり、デフォルトは null です。このパラメーターの指定が必要になることはほとんどありません。
|
int — int で表されたリソース値です。リソースが見つからない場合は 0 です。
|
getLocales | () | メソッド |
getNumber | () | メソッド |
public function getNumber(bundleName:String, resourceName:String, locale:String = null):Number
言語バージョン: | ActionScript 3.0 |
製品バージョン: | Flex 3 |
ランタイムバージョン: | Flash Player 9, AIR 1.1 |
数値として指定されているリソースの値を取得します。
このメソッドは getObject()
を呼び出し、結果を数値にキャストします。 このメソッドは、プロパティファイル内に次のような行があり、
LONGITUDE=170.3
プロパティファイル内にこのような行があり、170.3 という値("170.3"
ではなく)を取得する場合に役立ちます。
指定されたリソースが見つからない場合、このメソッドは NaN
を返します。
パラメーター
bundleName:String — リソースバンドルの名前です。
| |
resourceName:String — リソースバンドルのリソースの名前です。
| |
locale:String (default = null ) — 参照に使用する特定のロケールです。null の場合は、localeChain 内のすべてのロケールを検索します。 このパラメーターはオプションであり、デフォルトは null です。このパラメーターの指定が必要になることはほとんどありません。
|
Number — 数値としてのリソース値、または、リソースが見つからない場合は NaN です。
|
getObject | () | メソッド |
public function getObject(bundleName:String, resourceName:String, locale:String = null):*
言語バージョン: | ActionScript 3.0 |
製品バージョン: | Flex 3 |
ランタイムバージョン: | Flash Player 9, AIR 1.1 |
オブジェクトとして指定されているリソースの値を取得します。
ResourceBundle の content
オブジェクトに格納されているそのままの状態の値を、変換せずに返します。 リソースがプロパティファイルからコンパイルされた場合、content
オブジェクトのリソース値は常にストリングです。ただし、Embed()
ディレクティブまたは ClassReference()
ディレクティブを使用した場合、リソース値はクラスになります。 getString()
、getStringArray()
、getNumber()
、getInt()
、getUint()
、getBoolean()
、getClass()
の各メソッドを使用して、値をより具体的な型に変換します。
指定されたリソースが見つからない場合、このメソッドは undefined
を返します。
パラメーター
bundleName:String — リソースバンドルの名前です。
| |
resourceName:String — リソースバンドルのリソースの名前です。
| |
locale:String (default = null ) — 参照に使用する特定のロケールです。null の場合は、localeChain 内のすべてのロケールを検索します。 このパラメーターはオプションであり、デフォルトは null です。このパラメーターの指定が必要になることはほとんどありません。
|
* — content オブジェクトに格納されているそのままの状態のリソース値です。リソースが見つからない場合は undefined です。
|
getPreferredLocaleChain | () | メソッド |
public function getPreferredLocaleChain():Array
言語バージョン: | ActionScript 3.0 |
製品バージョン: | Flex 3 |
ランタイムバージョン: | Flash Player 9, AIR 1.1 |
Capabilities.language
または Capabilities.languages
により報告されたように、ユーザー環境設定を使用して順序付けられた、ResourceManager に存在する ResourceBundle オブジェクトのすべてのロケールを指定するストリングの配列を返します。
Array — ロケールストリングの配列です。
|
getResourceBundle | () | メソッド |
public function getResourceBundle(locale:String, bundleName:String):IResourceBundle
言語バージョン: | ActionScript 3.0 |
製品バージョン: | Flex 3 |
ランタイムバージョン: | Flash Player 9, AIR 1.1 |
指定された locale
と bundleName
を持つ ResourceBundle(以前に addResourceBundle()
を使用して ResourceManager に追加されたもの)を返します。 該当する ResourceBundle がない場合、このメソッドは null
を返します。
パラメーター
locale:String — "en_US" などのロケールストリングです。
| |
bundleName:String — "MyResources" などのバンドル名です。
|
IResourceBundle — 指定された locale および bundleName を持つ(存在する場合)ResourceBundle です。見つからない場合は null です。
|
関連する API エレメント
getString | () | メソッド |
public function getString(bundleName:String, resourceName:String, parameters:Array = null, locale:String = null):String
言語バージョン: | ActionScript 3.0 |
製品バージョン: | Flex 3 |
ランタイムバージョン: | Flash Player 9, AIR 1.1 |
ストリングとして指定されたリソースの値を、プレースホルダーを指定された値に置き換えた後で取得します。
このメソッドは getObject()
を呼び出し、結果をストリングにキャストします。
parameters
配列をこのメソッドに渡すと、配列の中のパラメーターがストリングに変換され、プレースホルダー("{0}"
や "{1}"
など)がそれらのストリングに順番どおりに置き換えられた後、結果のストリングが返されます。
指定されたリソースが見つからない場合、このメソッドは null
を返します。
パラメーター
bundleName:String — リソースバンドルの名前です。
| |
resourceName:String — リソースバンドルのリソースの名前です。
| |
parameters:Array (default = null ) — プレースホルダーの置き換えとなるパラメーターの配列です。 各パラメーターは、toString() メソッドを使用してストリングに変換された後で置き換えられます。
| |
locale:String (default = null ) — 参照に使用する特定のロケールです。null の場合は、localeChain 内のすべてのロケールを検索します。 このパラメーターはオプションであり、デフォルトは null です。このパラメーターの指定が必要になることはほとんどありません。
|
String — ストリングとしてのリソース値、または、リソースが見つからない場合は null です。
|
getStringArray | () | メソッド |
public function getStringArray(bundleName:String, resourceName:String, locale:String = null):Array
言語バージョン: | ActionScript 3.0 |
製品バージョン: | Flex 3 |
ランタイムバージョン: | Flash Player 9, AIR 1.1 |
ストリングの配列として指定されているリソースの値を取得します。
このメソッドは、カンマで区切られた項目のリストが格納されたストリングをリソース値と見なします。 このメソッドは、getString()
メソッドを呼び出し、ストリングをカンマの位置で項目に分割して、各項目の前後にある空白を除去します。 このメソッドは、プロパティファイル内に次のような行があり、
COUNTRIES=India, China, Japan
[ "India", "China", "Japan" ]
という値("India, China, Japan"
という値ではなく)を取得する場合に役立ちます。
指定されたリソースが見つからない場合、このメソッドは null
を返します。
パラメーター
bundleName:String — リソースバンドルの名前です。
| |
resourceName:String — リソースバンドルのリソースの名前です。
| |
locale:String (default = null ) — 参照に使用する特定のロケールです。null の場合は、localeChain 内のすべてのロケールを検索します。 このパラメーターはオプションであり、デフォルトは null です。このパラメーターの指定が必要になることはほとんどありません。
|
Array — ストリングの配列としてのリソース値、または、リソースが見つからない場合は null です。
|
getUint | () | メソッド |
public function getUint(bundleName:String, resourceName:String, locale:String = null):uint
言語バージョン: | ActionScript 3.0 |
製品バージョン: | Flex 3 |
ランタイムバージョン: | Flash Player 9, AIR 1.1 |
指定されたリソースの値を uint として取得します。
このメソッドは getObject()
メソッドを呼び出し、結果を uint にキャストします。 このメソッドは、プロパティファイル内に次のような行があり、
MINIMUM=5
5 という値("5"
ではなく)を取得する場合に役立ちます。
指定されたリソースが見つからない場合、このメソッドは 0 を返します。
パラメーター
bundleName:String — リソースバンドルの名前です。
| |
resourceName:String — リソースバンドルのリソースの名前です。
| |
locale:String (default = null ) — 参照に使用する特定のロケールです。null の場合は、localeChain 内のすべてのロケールを検索します。 このパラメーターはオプションであり、デフォルトは null です。このパラメーターの指定が必要になることはほとんどありません。
|
uint — uint で表されたリソース値です。リソースが見つからない場合は 0 です。
|
initializeLocaleChain | () | メソッド |
public function initializeLocaleChain(compiledLocales:Array):void
言語バージョン: | ActionScript 3.0 |
製品バージョン: | Flex 3 |
ランタイムバージョン: | Flash Player 9, AIR 1.1 |
オペレーティングシステムのユーザー推奨ロケールを SWF の使用可能なロケールのリストと比較するアルゴリズムを使用して、ResourceManager の localeChain
プロパティを初期化します。
例えば、ユーザーがオペレーティングシステムでフランス語を使用するように指定していた場合に、SWF が en_US、fr_FR および de_DE のロケールでコンパイルされた場合は、localeChain
の最初のロケールが fr_FR になるように設定されます。
このメソッドは、IFlexModuleFactory インターフェイスを実装するクラスのみによって使用されます。
パラメーター
compiledLocales:Array — SWF がコンパイルされたロケールを指定するストリングの配列です。
|
関連する API エレメント
installCompiledResourceBundles | () | メソッド |
public function installCompiledResourceBundles(applicationDomain:ApplicationDomain, locales:Array, bundleNames:Array, useWeakReference:Boolean = false):Array
言語バージョン: | ActionScript 3.0 |
製品バージョン: | Flex 3 |
ランタイムバージョン: | Flash Player 9, AIR 1.1 |
SWF にコンパイルされたすべての ResourceBundle サブクラスのインスタンスを作成して、ResourceManager に追加します。
例えば、locales
パラメーターが [ "en_US", "ja_JP" ] で、bundleNames
パラメーターが [ "core", "controls" ] の場合は、4 つのリソースバンドルがインストールされます。
このメソッドは、IFlexModuleFactory インターフェイスを実装するクラスのみによって使用されます。
パラメーター
applicationDomain:ApplicationDomain — リソースバンドルクラスを名前で参照するために使用される ApplicationDomain です。
| |
locales:Array — SWF がコンパイルされたロケールを指定するストリングの配列です。
| |
bundleNames:Array — SWF にコンパイルされたリソースバンドルの名前を指定するストリングの配列です。
| |
useWeakReference:Boolean (default = false ) — 弱参照を使用してリソースバンドルを ResourceManager にインストールするかどうかを指定するフラグです。
|
Array — 作成されて ResourceManager に追加された ResourceBundle インスタンスの配列です。
|
関連する API エレメント
loadResourceModule | () | メソッド |
public function loadResourceModule(url:String, update:Boolean = true, applicationDomain:ApplicationDomain = null, securityDomain:SecurityDomain = null):IEventDispatcher
言語バージョン: | ActionScript 3.0 |
製品バージョン: | Flex 3 |
ランタイムバージョン: | Flash Player 9, AIR 1.1 |
リソースバンドルを含むリソースモジュールのロードを開始します。
このメソッドを呼び出すたびに、新しいイベント送出オブジェクトが返されます。そのオブジェクトを使用すると、ロードの進捗状況およびロードが正常に完了したかまたはエラーが発生したかを確認できます。 このオブジェクトは、ResourceEvent.PROGRESS
、ResourceEvent.COMPLETE
、ResourceEvent.ERROR
の各イベントを送出します。
モジュールがロードされると、リソースバンドルが ResourceManager に追加されますが、localeChain
は変更されません。 update
パラメーターが true
の場合、update()
メソッドが呼び出されます。
パラメーター
url:String — リソースモジュールのロード元の URL です。
| |
update:Boolean (default = true ) — モジュールのロードが終了したときに update() メソッドを呼び出すかどうかを指定します。
| |
applicationDomain:ApplicationDomain (default = null ) — リソースモジュールをロードする IModuleInfo クラスの load() メソッドに渡される ApplicationDomain です。 このパラメーターはオプションで、デフォルトは null です。
| |
securityDomain:SecurityDomain (default = null ) — リソースモジュールをロードする IModuleInfo クラスの load() メソッドに渡される SecurityDomain です。 このパラメーターはオプションで、デフォルトは null です。
|
IEventDispatcher — ResourceEvent.PROGRESS 、ResourceEvent.COMPLETE 、ResourceEvent.ERROR の各イベントを送出するこの特定のロード操作に関連付けられたオブジェクトです。
|
関連する API エレメント
removeResourceBundle | () | メソッド |
public function removeResourceBundle(locale:String, bundleName:String):void
言語バージョン: | ActionScript 3.0 |
製品バージョン: | Flex 3 |
ランタイムバージョン: | Flash Player 9, AIR 1.1 |
指定された ResourceBundle が ResourceManager から削除され、getString()
などの ResourceManager メソッドでそのリソースにアクセスできなくなります。
パラメーター
locale:String — "en_US" などのロケールストリングです。
| |
bundleName:String — "MyResources" などのバンドル名です。
|
関連する API エレメント
removeResourceBundlesForLocale | () | メソッド |
public function removeResourceBundlesForLocale(locale:String):void
言語バージョン: | ActionScript 3.0 |
製品バージョン: | Flex 3 |
ランタイムバージョン: | Flash Player 9, AIR 1.1 |
指定されたロケールのすべての ResourceBundle が ResourceManager から削除され、getString()
などの ResourceManager メソッドでそのリソースにアクセスできなくなります。
パラメーター
locale:String — "en_US" などのロケールストリングです。
|
関連する API エレメント
unloadResourceModule | () | メソッド |
public function unloadResourceModule(url:String, update:Boolean = true):void
言語バージョン: | ActionScript 3.0 |
製品バージョン: | Flex 3 |
ランタイムバージョン: | Flash Player 9, AIR 1.1 |
ロード済みのリソースモジュールのアンロードを開始します。
モジュールがアンロードされると、そのリソースバンドルは ResourceManager から削除されますが、localeChain
は変更されません。update
パラメーターが true
の場合、update()
メソッドが呼び出されます。
パラメーター
url:String — リソースモジュールのロードに使用された URL です。
| |
update:Boolean (default = true ) — モジュールのアンロードが終了したときに update() メソッドを呼び出すかどうかを指定します。
|
update | () | メソッド |
public function update():void
言語バージョン: | ActionScript 3.0 |
製品バージョン: | Flex 3 |
ランタイムバージョン: | Flash Player 9, AIR 1.1 |
ResourceManager から change
イベントを送出します。
これにより、バインディング式に ResourceManager メソッドの getObject()
、getString()
、getStringArray()
、getNumber()
、getInt()
、getUint()
、getBoolean()
、getClass()
のいずれかが含まれる場合に、それらのバインディング式が再評価されます。
また、UIComponent、Formatter または Validator の resourcesChanged()
メソッドも実行されます。 多くのコンポーネントがこのメソッドを実装し、最新のリソースに基づいてその状態を更新します。
Tue Jun 12 2018, 10:34 AM Z