RCMenu 句

ローカル

<local_variable_decl> 、 <local_function_decl> 、 <local_struct_decl> は、MAXScript 内のローカル変数、関数、構造体の定義とまったく同義です。

<local_variable_decl> ::= local <decl> { , <decl> } 
<decl> ::= <name> [ = <expr> ] -- optional initial value

<local_function_decl> ::= [ mapped ](function | fn) <name> { <argument> } = <expr>

<local_struct_decl> ::= struct <name> ( <member> { , <member> })<member> ::= ( <name> [ = <expr> ] | <local_function_decl> )

local numSelected

local numSelected = 0

fn onlyOneSelected = selection.count == 1

struct parents (mother="",father="")

グローバル変数は、スクリプト化された右クリック メニュー句としては宣言できませんが、イベント ハンドラのスクリプト内では宣言できます。変数名がグローバル変数を確実に参照するようにするには、変数名をスクリプト内で右クリック メニューを定義する直前にグローバルとして宣言します。

スクリプトを作成するときは、ローカル変数およびグローバル変数を明示的に宣言することをお勧めします。暗示的な宣言は簡易的に提供されるものであり、通常、リスナーでインタラクティブに作業する場合や短いスクリプトを作成する場合に使用します。長いスクリプトを作成する場合は、変数を明示的に宣言するとエラーを軽減し、コードが読みやすくなります。また、特にグローバル変数を必要な場合を除き、すべての変数をローカルとして宣言することをお勧めします。この理由については、「変数のスコープ」を参照してください。

ユーザ インタフェース項目

<user_interface_item> は、右クリック メニューに表示される個々のメニュー項目、区切り記号、またはサブメニュー ユーザ インタフェース項目を定義します。これらのユーザ インタフェース コントロール項目については、「RCMenu ユーザ インタフェース項目」を参照してください。

イベント ハンドラ

イベント ハンドラ <event_handler> は、スクリプト化された右クリック メニューに対する特殊な関数定義ローカルで、ユーザがメニュー項目をクリックしたときに処理を起動するために使用します。このユーザ アクションは名前付きのイベントを生成し、このイベントに対するイベント ハンドラを呼び出します。ハンドラを定義する構文は次のようになります。

on <item_name> <event_name> do <expr>

<item_name> は、このハンドラが結びついている項目の名前を指定します。 <event_name> には、処理するイベントのタイプを指定します。

ユーザ インタフェース項目のイベントには次のタイプだけがあります。

picked

picked ハンドラ式は、右クリック メニューでメニュー項目が選択されたときに実行されます。オブジェクトの作成、モディファイヤの追加など、すべての MAXScript アクションはこの式で実行できます。

右クリック メニューの特定のメニュー項目に対して指定するイベント ハンドラに加え、ユーザが右クリック メニュー全体を初めて開いたときに呼び出されるハンドラ関数を定義できます。このイベント ハンドラは、初期化コードに便利です。イベント ハンドラを定義する構文は次のようになります。

on <rcmenu> open do <expr>