インタフェース: menuMan

メニューのロードと保存

<boolean>menuMan.loadMenuFile <filename>file 		

このメソッドでは、ディスクからメニュー ファイルをロードして、UI を自動的に更新することができます。メニュー ファイルがロードされた場合は true 、それ以外の場合は false を返します。

<string>file: ロードするメニュー ファイルのパスおよびファイル名。

<boolean>menuMan.saveMenuFile <filename>file 	 

このメソッドでは、メニュー ファイルをディスクに保存できます。メニュー ファイルが保存された場合は true 、それ以外の場合は false を返します。

<string>file: 保存するメニュー ファイルのパスおよびファイル名。

<string>menuMan.getMenuFile()   

このメソッドは、現在ロードされているファイルとアクティブなメニュー ファイルのファイル名を返します。

メニューの検索

<Interface>menuMan.findMenu <string>menuName 

このメソッドは、メニューの名前に基づいてメニューへのポインタを返します。メニューへの menu MixinInterface を返し、メニューが見つからなかった場合は undefined を返します。

<string>menuName: 返されるメニューの名前。

<Interface>menuMan.findQuadMenu <string>menuName 

このメソッドは、メニューの名前に基づいてクアッド メニューへのポインタを返します。クアッド メニューへの quadMenu MixinInterface を返し、クアッド メニューが見つからなかった場合は undefined を返します。

<string>menuName: 返されるメニューの名前。

メニュー数の問い合わせ

<integer>menuMan.numMenus() 

メニュー マネージャに登録されているメニューの総数を返します。

<integer>menuMan.numQuadMenus() 

メニュー マネージャに登録されているクアッド メニューの総数を返します。

メニューの取得

<Interface>menuMan.getMenu <index>index 

メニュー マネージャのインデックスで指定されたメニューを取得します。インデックスの基数は 1 です。menu MixinInterface を返します。

<Interface>menuMan.getQuadMenu <index>index 

メニュー マネージャのインデックスで指定されたクアッド メニューを取得します。インデックスの基数は 1 です。quadMenu MixinInterface を返します。

メニューの作成

<Interface>menuMan.createMenu <string>name 

このメソッドは、指定された名前で新しい空のメニューを作成し、menu MixinInterface を返します。

<Interface>menuMan.createQuadMenu <string>name <string>quad1Name <string>quad2Name <string>quad3Name <string>quad4Name 

新しい空のクアッド メニューを作成します。これには 4 つの空のメニュー(各クアッド メニューに 1 つずつ)が含まれます。quadMenu MixinInterface を返します。

<Interface>menuMan.createSubMenuItem <string>name <Interface>subMenu 

メニューに追加可能な新しいサブメニュー項目を作成します。指定された「name」を使用して、指定されたサブメニューを表示します。MenuItem MixinInterface を返します。

<Interface>menuMan.createSeparatorItem() 

メニューに追加可能な新しいサブメニュー項目を作成します。指定された「name」を使用して、指定されたサブメニューを表示します。MenuItem MixinInterface を返します。

<Interface>menuMan.createActionItem <string>macroScriptName <string>macroScriptCategory 

メニューに追加可能な新しいメニュー項目を作成します。メニュー項目は、指定された名前とカテゴリ付きのマクロ スクリプトを実行するアクションです。正常に終了した場合は MenuItem MixinInterface を返し、指定された名前とカテゴリ付きの macroScript がない場合は、「undefined」を返します。

<Interface>menuMan.createMenuItemFromAction <string>group <string>action category:<string> 

category 既定値: undefined

このメソッドはアクションから新しいメニュー項目を作成し、menu MixinInterface を返します。

3ds Max 2008 以降 で使用可能です。

ビューポートの右クリック メニュー

<boolean>menuMan.setViewportRightClickMenu <enum>which <Interface>menu 

which enums: {#nonePressed | #shiftPressed | #altPressed | #controlPressed | #shiftAndAltPressed | #shiftAndControlPressed | #controlAndAltPressed | #shiftAndAltAndControlPressed} 		  

このメソッドでは、ビューポートの右クリック メニューを指定されたクアッド メニューに設定できます。正常に設定された場合は true を返します。

<enum>which: 上記の右クリック コンテキストのリストを参照してください。

<Interface>menu: 設定するクアッド メニューへのポインタ。

<Interface>menuMan.getViewportRightClickMenu <enum>which 

which enums: {#nonePressed | #shiftPressed | #altPressed | #controlPressed | #shiftAndAltPressed | #shiftAndControlPressed | #controlAndAltPressed | #shiftAndAltAndControlPressed}

このメソッドは、現在のビューポートの右クリック クアッド メニューへの quadMenu MixinInterface を返します。

<enum>which: 右クリック コンテキストのリストを参照してください。

メイン メニュー バー

<Interface>menuMan.getMainMenuBar() 

このメソッドは、メイン メニュー バーへの menu MixinInterface を返します。

<boolean>menuMan.setMainMenuBar <Interface>menu 

このメソッドでは、メイン メニュー バーを設定できます。正常に設定された場合は true を返します。

<Interface>menu: メイン メニュー バーとして設定するメニューへの menu MixinInterface。

クアッドメニューの設定

<bool>menuMan.getShowAllQuads <Interface>quadMenu 

このメソッドは、特定のクアッドメニューに「すべてのクアッドを表示」フラグが設定されているかどうかを確認します。このメソッドは、フラグが設定されている場合は true 、フラグが設定されていない場合は false を返します。

<Interface>quadMenu: フラグを確認するクアッドメニューへの quadMenu MixinInterface。

<void>menuMan.setShowAllQuads <Interface>quadMenu <bool>value 

このメソッドは、特定のクアッドメニューに「すべてのクアッドを表示」フラグを設定します。

<Interface>quadMenu: フラグを設定するクアッドメニューへの quadMenu MixinInterface。

<bool>value: フラグをオンに設定する場合は True、フラグをオフに設定する場合は false を指定します。

<string>menuMan.getQuadMenuName <Interface>quadMenu 

このメソッドは、特定のクアッドメニューに指定された名前を文字列で返します。

<Interface>quadMenu: 名前を取得するクアッドメニューへの quadMenu MixinInterface。

<void>menuMan.setQuadMenuName <Interface>quadMenu <string>name 

このメソッドでは、特定のクアッドメニューの名前を設定できます。

<Interface>quadMenu: 名前を設定するクアッドメニューへの quadMenu MixinInterface。

<string>name: クアッドメニューの名前を含む文字列。

メニューの更新

<void>menuMan.updateMenuBar() 

このメソッドは、サブメニューまたはメニュー項目の追加後に 3ds Max のメイン メニュー バーを更新するために呼び出すことができます。

<boolean>menuMan.registerMenuContext <integer>contextId 

3ds Max のメイン メニューに項目を追加するには、プラグインで RegisterMenuContext() の戻り値をチェックする必要があります。 true の場合は、これが初めての登録であることを意味し、プラグインで新しいメニューを作成し、項目を 3ds Max のメイン メニューとクアッド メニューに追加することができます。

メニューの登録解除

<boolean>menuMan.unRegisterMenu <Interface>menu 

このメソッドでは、マネージャからメニューを削除できます。メニューが登録されていなかった場合は false 、登録が正常に解除された場合は true を返します。

<Interface>menu: 登録を解除するメニューをポイントします。

<boolean>menuMan.unRegisterQuadMenu <Interface>quadMenu 

これは「unregisterMenu」と似ていますが、クアッド メニュー用です。

Mixin インタフェース: menuMan.getMenu(...)

Interface: menu 

menu [Mixin Interface] は、このページで前述されているいくつかのメソッドによって返されます。

メソッド:

<void><MixinInterface:menu>.setTitle <string>title 

メニュー タイトルを指定された文字列に設定します。

<&string><MixinInterface:menu>.getTitle() 

メニュー タイトルを返します。

<integer><MixinInterface:menu>.numItems() 

メニュー項目の数を返します。

<Interface><MixinInterface:menu>.getItem <index>position 

インデックスで指定されたメニュー項目への menuItem MixinInterface を返します。

<void><MixinInterface:menu>.addItem <Interface>item <index>position 

指定された位置のメニューに新しいメニュー項目を追加します。

<void><MixinInterface:menu>.removeItemByPosition <index>position 

インデックスで指定されたメニュー項目を削除します。

<void><MixinInterface:menu>.removeItem <Interface>item 

指定されたメニュー項目を削除します。

Mixin インタフェース: menuMan.getQuadMenu(...)

Interface: quadMenu 

quadMenu [Mixin Interface] は、このページで前述されているいくつかのメソッドによって返されます。

メソッド:

<Interface><MixinInterface:quadMenu>.getMenu <index>position 

インデックスで指定されたメニュー(1 から 4)への menu MixinInterface を返します。

<void><MixinInterface:quadMenu>.trackMenu <bool>showAllQuads 

true に設定された場合は、quadMenu によってすべてのクアッドが強制的に表示されます。

Mixin インタフェース: menuMan.createSubMenuItem(...)

Interface: menuItem 

menuItem [Mixin Interface] は、このページで前述されているいくつかのメソッドによって返されます。

メソッド:

<void><MixinInterface:menuItem>.setTitle <string>title 

メニュー項目のタイトルを指定された文字列に設定します。

<&string><MixinInterface:menuItem>.getTitle() 

メニュー項目のタイトルを返します。

<bool><MixinInterface:menuItem>.setUseCustomTitle <bool>value 

true が指定された場合は、メニュー項目によってカスタム タイトルが強制的に表示されます。

<bool><MixinInterface:menuItem>.getUseCustomTitle() 

カスタム タイトルが使用可能な場合は true、それ以外の場合は false を返します。

<bool><MixinInterface:menuItem>.setDisplayFlat <bool>value 

true が指定された場合は、メニュー項目がフラットとして強制的に表示されます。

<bool><MixinInterface:menuItem>.getDisplayFlat() 

メニュー項目がフラットとして表示されるように設定されている場合は true を返します。

<bool><MixinInterface:menuItem>.getIsSeparator() 

メニュー項目がセパレータの場合は true を返します。

<Interface><MixinInterface:menuItem>.getSubMenu() 

サブメニューへの menu MixinInterface を返します。