ジャンプ先: 概要. 注. 戻り値. 関連. 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 を使用します。

戻り値

string: キーに関連する文字列リソース値です。キーが見つからない場合、戻り値は空です。

関連

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");