dotnetobject

3ds Max 9 以降では、 dotNetObject の値のクラスは、DotNet オブジェクトのインスタンスをラップします。dotNetObject 値クラスは、DotNet System::Object オブジェクトに対する MAXScript ラッパークラスです。

dotNetObject クラスは、DotNet オブジェクトに関連するプロパティ、メソッド、およびイベントを、反映（リフレクション）を介して公開します。

プロパティアクセスには、MAXScript の数値データタイプ(必要に応じて桁数を調整)、文字列、ブール値、dotNetControl、dotNetObject、dotNetClass の各値が使用されます。

dotNetObject のプロパティに対するアクセスには、通常のプロパティアクセスの指定[object.property]、および getProperty() / setProperty() メソッドが使用されます。

オブジェクトメソッドにアクセスすることによって、dotNetMethod インスタンスが作成されます。

イベントハンドラの追加および管理には新しいメソッドが使用されます。イベントが発生すると、これらの新しいメソッドは呼び出すべきコールバック関数の登録および登録解除を行います。コールバック関数に渡される引数には、オブジェクト、イベント名、イベントハンドラによって渡された引数などがあります。詳細は、「dotNet 構造体のメソッド」を参照してください。

注:

同じタイプをラップする場合でも、dotNetClass と dotNetObject では違いがあります。

dotNetClass にアクセスする場合は System::Type にアクセスすることになりますが、dotNetObject の場合は System::Type によって記述されたオブジェクトタイプにアクセスします。

このため、たとえばある dotNetObject に対して showProperties() を呼び出した場合、この dotNetObject がラップする System::Type のプロパティを取得できますが、同じタイプをラップする dotNetClass に対して showProperties() を呼び出した場合は、System::Type 自体のプロパティを取得できます。

コンストラクタ:

dotNetObject { <dotNetClass> | <class_type_string> } ... additional args as needed ...

dotNetObject オブジェクトを構築します。

dotNetObject は、クラスタイプ文字列を使用して作成するか、dotNetClass から作成します。

例:

o1 = dotNetObject "System.Drawing.Size" 10 20 -- existing object
o2 = dotNetClass "System.Drawing.Size"
o3 = dotNetObject o2 10 20 -- newobject from class

オペレータ

== !=

メソッド:

getProperty <dotNetObject> <prop name> [  asDotNetObject:<bool>]

指定されたプロパティの値を返します。

asDotNetObject が false (既定値)の場合は、この値は可能ならネイティブ MAXScrript 値に変換され、true の場合は、この値は dotNetControl または dotNetObject の値として返されます。

setProperty <dotNetObject> <prop name> <value>

指定されたプロパティの値を設定します。指定された値がネイティブ MAXScript 値である場合は、この値は可能であれば適切な DotNet 値に変換されます。

getPropNames <dotNetObject> [showStaticOnly:<bool>] [declaredOnTypeOnly:<bool>]

オブジェクトによって公開されるプロパティ名の配列を返します。

showStaticOnly が true (既定値)の場合は静的プロパティのみが表示され、false の場合は静的プロパティとインスタンスプロパティが表示されます。

declaredOnTypeOnly が true の場合は、指定したオブジェクトについて宣言されているプロパティのみが表示され、false (既定値)の場合はそのオブジェクトのプロパティとそのオブジェクトの派生元であるクラスが表示されます。

このメソッドの結果は、名前でソートされます。実際に返されるプロパティには、DotNet でいうプロパティとフィールドの 2 つの内容が含まれています。最初にプロパティがソート順に表示され、続いてフィールドがソート順に表示されます。

showProperties <dotNetObject> ["prop_pat"] [to:<stream>] [showStaticOnly:<bool>] [showMethods:<bool>] [showAttributes:<bool>] [declaredOnTypeOnly:<bool>]

プロパティパターン(prop_pat)に一致する名前を持ったオブジェクトによって公開されるプロパティを表示します。

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

showStaticOnly が true (既定値)の場合は静的プロパティのみが表示され、false の場合は静的プロパティとインスタンスプロパティが表示されます。

showMethods が true の場合は、get メソッドおよび set メソッドのシグネチャ(存在する場合)が表示されます。既定値は false です。

showAttributes が true の場合は、プロパティに関連付けられているアトリビュートが表示されます。既定値は false です。

showMethods <dotNetObject> ["prop_pat"] [to:<stream>] [showStaticOnly:<bool>] [showSpecial:<bool>] [showAttributes:<bool>] [declaredOnTypeOnly:<bool>]

プロパティパターン(prop_pat)に一致する名前を持ったオブジェクトによって公開されるメソッドを表示します。

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

showStaticOnly が true (既定値)の場合は静的プロパティのみが表示され、false の場合は静的プロパティとインスタンスプロパティが表示されます。

showSpecial が true の場合は、通常はユーザによって呼び出されることのないメソッド(プロパティ値を設定するためのメソッドやイベントハンドラを起動するためのメソッド)が表示されます。既定値は false です。

showAttributes が true の場合は、プロパティに関連付けられているアトリビュートが表示されます。既定値は false です。

結果は、名前でソートされます。ソートにおいて名前の次に優先されるのは、パラメータの数です。

showEvents <dotNetObject> ["prop_pat"] [to:<stream>] [showStaticOnly:<bool>] [declaredOnTypeOnly:<bool>]

プロパティパターン(prop_pat)に一致する名前を持ったオブジェクトによって公開されるイベントを表示します。

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

showStaticOnly が true (既定値)の場合は静的プロパティのみが表示され、false の場合は静的プロパティとインスタンスプロパティが表示されます。

結果は、名前でソートされます。

dotNet.showConstructors <dotNetClass> [to:<stream>]

このオブジェクトによって公開されるコンストラクタを表示します。

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

結果は、名前でソートされます。ソートにおいて名前の次に優先されるのは、パラメータの数です。

dotnetobject

関連事項