イベントハンドラの登録

イベントハンドラを XSIL:oadPlugin に登録します。これは、Softimage が自動インストールできるプラグインをロードするときにコールされます。XSIL:oadPlugin は PluginRegistrar または PluginRegistrar オブジェクトを Softimage から取得し、PluginRegistrar.RegisterEvent または PluginRegistrar::RegisterEvent メソッドを使用して、各種のイベントのハンドラを登録します。

C++ の例: イベントハンドラを登録する

XSIPLUGINCALLBACK CStatus XSILoadPlugin( PluginRegistrar& in_reg )
{
	in_reg.PutAuthor(L"Event Wizard User");
	in_reg.PutName(L"MyCppEventHandlers");
	in_reg.PutVersion(1,0);
	in_reg.RegisterEvent( L"MyOnSelectionChange", siOnSelectionChange );
	return CStatus::OK;
}

PluginRegistrar.RegisterEvent または PluginRegistrar::RegisterEvent への 1 番目のパラメータは、イベントハンドラの名前です。この名前を使用して、イベントハンドラを実装するコールバック関数が名前付けされます。たとえば、"MyOnSelectionChange" という名前のイベントハンドラの OnEvent コールバックは、"MyOnSelectionChange_OnEvent" になります。

EventInfoCollection または CRefArray of EventInfo 内のイベントの名前にもなり、XSIApplication.EventInfos または Application::GetEventInfos によって戻されます。

イベントハンドラ名の先頭文字には英字を使用します。先頭文字以外には、英字、数字、アンダースコア(_)、またはスペースを指定できます。「My Event」のようにイベントハンドラ名にスペースが含まれている場合は、コールバック関数名に含まれるスペースを削除して、「MyEvent_OnEvent」のようにしてください。
2 番目の引数は、siEventID(event の siEventID、その event が OnEvent コールバックをトリガーする)です。