移動先: 概要 戻り値 フラグ. Python 例.

概要

menuSetPref( [object] , [exists=boolean], [force=boolean], [loadAll=boolean], [removeAll=boolean], [saveAll=boolean], [saveBackup=boolean], [version=boolean])

注意: オブジェクト名や引数を表す文字列はカンマで区切ります。これは概要には示されていません。

menuSetPref は 「元に戻す」が可能、「照会」が可能、「編集」が可能 です。

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

戻り値

なし

戻り値の型は照会モードでは照会フラグが基になります。

フラグ

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

: コマンドの作成モードで使用可能なフラグ : コマンドの編集モードで使用可能なフラグ
: コマンドの照会モードで使用可能なフラグ : タプルまたはリストとして渡された複数の引数を持てるフラグ

Python 例

import maya.cmds as cmds

# saving the current menuSets
cmds.menuSetPref( saveAll=True )

# loading to the current menuSets if they exist
if cmds.menuSetPref(exists=True) :
	cmds.menuSetPref(loadAll=True)

# in certain cases, you may wish to remove previous preferences before saving
cmds.menuSetPref( removeAll=True )