ジャンプ先: 概要. 戻り値. フラグ. 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
ロング ネーム(ショート ネーム) 引数タイプ プロパティ
exists(e) boolean query
メニュー セット プリファレンス ファイルが存在するかどうかを返します。
force(f) boolean createedit
エラーに遭遇しても(無効なプリファレンスなど)、強制的に指定した操作を続行します。
loadAll(la) boolean create
プリファレンス バージョンが一致しているか、または -force フラグが有効な場合のみ、プリファレンス ファイルからすべてのメニュー セットをロードします。プリファレンス ファイルのロードに成功した場合は、空の文字列が返され、失敗した場合は、遭遇した問題の説明が返されます。
removeAll(ra) boolean create
プリファレンス ファイルからすべてのメニュー セットを除去します(ファイル全体を除去)。
saveAll(sa) boolean create
すべての現在のメニュー セットをプリファレンス ファイルに保存します。
saveBackup(sb) boolean create
現在のメニュー セット プリファレンス ファイルがあれば、そのバックアップを保存します。このバックアップは、現在のプリファレンス ファイルと同じ場所に保存されます。
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 )