移動先: 概要 注記. 戻り値 関連項目. MEL 例.

概要

loadPluginLanguageResources(string $pluginName, string $pluginResourceFile)

プラグインに登録した文字列リソースのローカライズされた値をロードします。 このプロシージャは、プラグインのリソースのデフォルト値を言語に適した値でオーバーライドするために提供されたスクリプトファイルの名前を取ります。

このファイルは、Maya がローカライズ モードで動作しており、UI 言語に適したファイルが見つかる場合だけ使用されます(下記参照)。 それ以外の場合は、リソース用に登録されているデフォルト値が使用されます。

これは、MFnPlugin::registerUIStrings を使用して設定した UI 文字列登録プロシージャから呼び出します。 正しく設定されている場合は、プラグインのロード中に呼び出され、プラグインの実行の後続手順のデフォルトまたはローカライズされている値に文字列を正しく設定します。

Maya がローカライズ モードで動作している場合、指定した名前の言語依存リソース ファイルが MAYA_PLUG_IN_RESOURCE_PATH で検索され、見つかった場合は提供されます。

MAYA_PLUG_IN_RESOURCE_PATH は、次の位置を含むように構成されています。カレントのローカライズ言語の Maya のデフォルト リソースの位置、MAYA_MODULE_PATH の処理中にすべてのモジュール位置で見つかった言語サブディレクトリ。

検索パスのカレント値を確認するには、getenv("MAYA_PLUG_IN_RESOURCE_PATH") を呼び出します。これはローカライズ環境にのみ関係します。

注記

プラグイン リソースは、registerPluginResources を使用して定義され、setPluginResource コマンドを使用してオーバーライドされます(ローカライズのために)。 アクセスには、getPluginResource を使用します。

戻り値

なし

関連項目

getPluginResource, registerPluginResource, setPluginResource

引数

変数名 変数型 説明
$pluginNamestring固有のプラグイン名です。
$fileNamestringロードする文字列リソース ファイルの名前です(パスなしのファイル名のみ)。

MEL 例

  // Load localized resources for the plugin "myPlugin"  
  // when required. 
  // The resources are located in a file "myPluginStrings.res.mel"
  // No action will be taken if the file is not found. 
  loadPluginLanguageResources("myPlugin", "myPluginStrings.res.mel");