v5.0

アドオン用のサブディレクトリを Addons ディレクトリ内に作成します。

たとえば、AddonName が Foo で、RootPath がユーザ パスの場合、CreateAddonDirectories はディレクトリ /Addons/Foo だけでなく、/Addons/foo/Application/Plugins のようなネストされたサブディレクトリも作成します 。

CreateAddonDirectories を使ってアドオンをディレクトリに置くと Softimage がアドオンを検出できるようになり、.xsiaddon ファイルへのアドオンのパッケージングが容易になります。 たとえば、アドオンで使用されるすべてのツールバーを[/Addons/foo/Application/toolbars]フォルダに入れる必要があります。

注: アドオンがすでに存在している場合はこのコマンドが無効です。

oString = CreateAddonDirectories( RootPath, AddonName );

有効な名前の場合は空の String (文字列)が戻され、無効な名前の場合はエラー メッセージが戻されます。 よくあるエラーの原因として考えられるのは、パス引数が無効であるか、指定の場所にフォルダを作成する権限がないことです。

パラメータ	タイプ	説明
RootPath	文字列	アドオンのディレクトリを作成する場所。 通常は、ユーザ パス(siUserPath)またはワークグループの場所です(「XSIApplication.Workgroups」を参照)。
AddonName	文字列	アドオンの名前。

JScript の例

/*

	This example showing a failed attempt to create an addon

	at an invalid path (":" is not a valid character for a directory name)

*/

strErrMsg = CreateAddonDirectories( Application.InstallationPath( siUserPath ), ":foo" ) ;

	

if ( strErrMsg.length > 0 )

	XSIUIToolkit.MsgBox( strErrMsg ) ;

CreateWorkgroupDirectories