イベントハンドラの登録

 
 
 

イベントハンドラを XSIL:oadPlugin に登録します。これは、Softimage が自動インストールできるプラグインをロードするときにコールされます。XSIL:oadPluginPluginRegistrar または 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 コールバックをトリガーする)です。