ジャンプ先: 概要. 戻り値. フラグ. MEL 例.

概要

menuSetPref [-exists] [-force] [-loadAll] [-removeAll] [-saveAll] [-saveBackup] [-version] [object]

menuSetPref は、取り消し可能、照会可能、および編集可能です。

Maya のセッション間でメニュー セットを保存してロードする機能を提供します。内部使用限定。

戻り値

なし

照会モードでは、戻り値のタイプは照会されたフラグに基づきます。

フラグ

exists, force, loadAll, removeAll, saveAll, saveBackup, version
ロング ネーム(ショート ネーム) 引数タイプ プロパティ
-exists(-e) query
メニュー セット プリファレンス ファイルが存在するかどうかを返します。
-force(-f) createedit
エラーに遭遇しても(無効なプリファレンスなど)、強制的に指定した操作を続行します。
-loadAll(-la) create
プリファレンス バージョンが一致しているか、または -force フラグが有効な場合のみ、プリファレンス ファイルからすべてのメニュー セットをロードします。プリファレンス ファイルのロードに成功した場合は、空の文字列が返され、失敗した場合は、遭遇した問題の説明が返されます。
-removeAll(-ra) create
プリファレンス ファイルからすべてのメニュー セットを除去します(ファイル全体を除去)。
-saveAll(-sa) create
すべての現在のメニュー セットをプリファレンス ファイルに保存します。
-saveBackup(-sb) create
現在のメニュー セット プリファレンス ファイルがあれば、そのバックアップを保存します。このバックアップは、現在のプリファレンス ファイルと同じ場所に保存されます。
-version(-v) query
ファイルに保存されたベース バージョンの文字列です。これは、最後にプリファレンスが保存されてからの既定のプリファレンスの変更を示すために、ロード時にもチェックされます。
フラグはコマンドの作成モードで表示できます フラグはコマンドの編集モードで表示できます
フラグはコマンドの照会モードで表示できます コマンド内でフラグを複数回使用できます。

MEL 例

// saving the current menuSets
menuSetPref -saveAll;

// loading to the current menuSets if they exist
if (`menuSetPref -exists`)
    menuSetPref -loadAll;

// in certain cases, you may wish to remove previous preferences before saving
menuSetPref -removeAll;