dotNet 構造体のメソッド

アセンブリのロード:

<dotNetObject>dotNet.loadAssembly <assembly>

このメソッドは、指定されたアセンブリをロードします。ロードするアセンブリは、アセンブリ名またはそのアセンブリを含んでいる dll のファイル名で指定します。

このメソッドはまず、アセンブリ名を使用してアプリケーションディレクトリから、またはグローバルアセンブリキャッシュからのアセンブリのロードを試みます。これでロードできない場合は、プライマリの .net アセンブリが含まれているディレクトリ内でアセンブリ名の付いた dll を検索します。

アセンブリが存在し、正常にロードされた場合は、.net アセンブリ値をラップする dotNetObject 値が返され、それ以外の場合は undefined 値が返されます。

例

dotnet.loadAssembly "system.xml"
dotnet.loadAssembly "system.xml.dll"
dotnet.loadAssembly "C:\\WINDOWS\\Microsoft.NET\\Framework\\v2.0.50727\\system.xml.dll"
dotnet.loadAssembly "C:\\WINDOWS\\Microsoft.NET\\Framework\\v2.0.50727\\system.xml"

注:

既存の dotNet クラスを使用して同じ処理を行うこともできます。

例

assembly = dotNetClass "System.Reflection.Assembly" r = assembly.loadfrom "F:\\FlashTrackBar\\bin\\Debug\\FlashTrackBar.dll"

イベントハンドラ:

dotNet.addEventHandler <dotNetControl> <EventNameString> <function>

このメソッドは、1 番目の引数として渡された dotNetControl にイベントハンドラを追加します。

2 番目の引数は文字列でイベント名を指定します。特定の dotNetControl で利用可能な全イベントのリストは、その dotNetControl 値に対して showEvents()を呼び出すことにより取得できます。

3 番目の引数は、イベントがトリガされたときに呼び出されるカスタム MAXScript 関数です。

ハンドラによって呼び出されたカスタム MAXScript 関数が 2 つの引数を要求する場合、1 番目の引数にはセンダー、2 番目の引数には eventArg が渡されます。

イベントハンドラ関数が引数を 1 つだけを指定する場合、eventArg だけが渡されます。

イベントハンドラ関数が引数を 1 つも指定しない場合、何も渡されません。

詳細はこのページの例を参照してください。

注: dotNet.addEventHandler() を使用すれば、異なる数の引数を持つ複数の関数を同一のイベントに対して登録できます。

dotNet.removeAllEventHandlers <dotNetControl>

指定された dotNetControl から、すべてのイベントハンドラを削除します。

dotNet.removeEventHandler <dotNetControl> <EventNameString> <function>

指定されたイベントハンドラ関数を指定された dotNetControl およびイベントから削除します。

引数リストは、 dotNet.addEventHandler() の場合と同じです。

同じイベントに複数の関数を登録することができるため(上記の注を参照)、コールバック関数を 3 番目の引数として指定する必要があります。

特定のイベントに登録されたすべての関数を削除するには、以下のメソッドを参照してください。

dotNet.removeEventHandlers <dotNetControl> <EventNameString>

指定された dotNetControl のイベントに登録されているすべての関数を削除します。

例:

(
fn buttonPressed1 a1 a2 =
(
print "1. Button Pressed - Two Arguments"
print a1
print a2
)
fn buttonPressed2 a1 =
(
print "2. Button Pressed - One Argument"
print a1
)
fn buttonPressed3 =
(
print "3. Button Pressed - No Arguments"
)
fn mouseEnter4 =
(
print "4. Mouse Entered The Button!"
)
fn mouseLeave5 =
(
print "5. Mouse Left The Button!"
)
local mButton = dotNetObject "System.windows.forms.button"
mButton.text = "Press Me"
mButton.size = dotNetObject "System.Drawing.Size" 100 100
mButton.location = dotNetObject "System.Drawing.Point" 10 10
local hForm = dotNetObject "System.Windows.Forms.Form"
hForm.size = dotNetObject "System.Drawing.Size" 120 140
hForm.controls.add mButton
dotNet.addEventHandler mButton "click" buttonPressed1
dotNet.addEventHandler mButton "click" buttonPressed2
dotNet.addEventHandler mButton "click" buttonPressed3
dotNet.addEventHandler mButton "MouseEnter" mouseEnter4
dotNet.addEventHandler mButton "MouseLeave" mouseLeave5
hForm.show()
ok
)

上のスクリプトを評価し、マウスをボタンの上に移動してクリックした後、マウスをボタンから離し、再びボタンの上に乗せてから離すとリスナー出力は次のようになります。

OK
"4. Mouse Entered The Button!"
"1. Button Pressed - Two Arguments"
dotNetObject:System.Windows.Forms.Button
dotNetObject:System.Windows.Forms.MouseEventArgs
"2. Button Pressed - One Argument"
dotNetObject:System.Windows.Forms.MouseEventArgs
"3. Button Pressed - No Arguments"
"5. Mouse Left The Button!"
"4. Mouse Entered The Button!"
"5. Mouse Left The Button!"

1 つ目の関数(buttonPressed1)に以下の行を追加すると、ボタンを最初にクリックした後、1 つ目の on Click イベントハンドラが削除されます。2 回目のクリックでは、2 つ目と 3 つ目の関数だけがリスナーへの出力を行います。

この関数内では、a1 引数に「センダー」、つまりトリガされたイベントが属する dotNetControl が含まれます。

dotNet.removeEventHandlers a1 "click" buttonPressed1

OK
"4. Mouse Entered The Button!"
"1. Button Pressed - Two Arguments"
dotNetObject:System.Windows.Forms.Button
dotNetObject:System.Windows.Forms.MouseEventArgs
"3. Button Pressed - No Arguments"
"2. Button Pressed - One Argument"
dotNetObject:System.Windows.Forms.MouseEventArgs
"3. Button Pressed - No Arguments"
"2. Button Pressed - One Argument"
dotNetObject:System.Windows.Forms.MouseEventArgs
"3. Button Pressed - No Arguments"
"5. Mouse Left The Button!"
--additional clicks result in no output from function 1
--but all others work

1 つ目の関数(buttonPressed1)に以下の行を追加すると、最初にボタンをクリックした後、すべての on Click イベントハンドラが削除されます。

2 回目のクリックではリスナーに何も出力されませんが、マウスをボタンの上に乗せたり離したりすると、他の 2 つの関数が出力を行います。

dotNet.removeEventHandlers a1 "click"

OK
"4. Mouse Entered The Button!"
"1. Button Pressed - Two Arguments"
dotNetObject:System.Windows.Forms.Button
dotNetObject:System.Windows.Forms.MouseEventArgs
"2. Button Pressed - One Argument"
dotNetObject:System.Windows.Forms.MouseEventArgs
"3. Button Pressed - No Arguments"
"5. Mouse Left The Button!"
"4. Mouse Entered The Button!"
"5. Mouse Left The Button!"
--additional clicks result in no output
--but moving the mouse prints to the Listener

1 つ目の関数(buttonPressed1)に以下の行を追加すると、最初にボタンをクリックした後、on Click、on MouseEnter、on MouseLeave を含むすべてのイベントハンドラが削除されます。

dotNet.removeAllEventHandlers a1

OK
"4. Mouse Entered The Button!"
"1. Button Pressed - Two Arguments"
dotNetObject:System.Windows.Forms.Button
dotNetObject:System.Windows.Forms.MouseEventArgs
"2. Button Pressed - One Argument"
dotNetObject:System.Windows.Forms.MouseEventArgs
"3. Button Pressed - No Arguments"
--additional clicks result in no output

その他の調査関数:

dotNet.showConstructors [<dotNetClass> | <dotNetObject> | <dotNetControl>] [to:<stream>]

指定された DotNetClass、DotNetObject、または DotNetControl によって公開されるコンストラクタを表示します。

to が指定されていない場合はリスナーに出力され、それ以外の場合は指定されたストリームに出力されます。

dotNet.getType<type_string>

type_string に指定された System:Type をラップする dotNetObject 値を返します。

Enums:

dotnet.combineEnums {<dotNetObject> | <number>}+

System::Enum から派生する、ビットフィールドとして処理すべきオブジェクト(FlagsAttribute を持つもの)を結合します。System::Enum 派生オブジェクトは、すべて同一の種類である必要があります。戻り値も同じ種類です。数字を指定する場合は、少なくとも 1 つの System::Enum 派生オブジェクトも(種類を指定するために)同時に指定する必要があります。

dotnet.CompareEnums{<dotNetObject> | <number>} {<dotNetObject> | <number>}

2 つの値をビットレベルで比較します。それぞれの値の中に少なくとも 1 個の対応するビットが設定されている場合は true を返します。

例:

BindingFlags= dotNetClass "System.Reflection.BindingFlags"
--> dotNetClass:System.Reflection.BindingFlags
BindingFlags.Static.value__
--> 8
BindingFlags.Public.value__
--> 16
BindingFlags.FlattenHierarchy.value__
--> 64
res = dotNet.combineEnums BindingFlags.Static BindingFlags.Public 2
--> dotNetObject:System.Reflection.BindingFlags
res.value__
--> 26
dotNet.compareEnums res 1
--> false
dotNet.compareEnums res BindingFlags.Static
--> true
dotNet.compareEnums res BindingFlags.Public
--> true
dotNet.compareEnums res BindingFlags.FlattenHierarchy
--> false

値変換:

dotNet.ValueToDotNetObject <value> { <dotNetClass> | <dotNetObject> }

詳細については、「MAXScript と Dotnet の値の変換」を参照してください。

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

寿命制御:

dotNet.setLifetimeControl {<dotNetObject> | <dotNetClass>} {#mxs | #dotnet}

詳細については、「DotNet オブジェクトおよびクラスの寿命制御」を参照してください。

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