|
インタフェース > コア インタフェース > menuMan |
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
メニューに追加可能な新しいメニュー項目を作成します。メニュー項目は、指定された名前とカテゴリ付きのマクロ スクリプトを実行するアクションです。macroScriptCategory 引数は、MacroScript の internalCategory が定義されていればこの値を取り、定義されていない場合は category になります。正常に終了した場合は MenuItem MixinInterface を返します。internalCategory または category が定義されている、指定した名前の 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 を返します。