//-------------------------------------------------------------------

// This example defines & runs a custom command examples

//

//

// README: Copy and paste the example into the script editor 

// and run (F5).

//

// The command will be listed in the customize toolbar dialog in

// the 'Custom Commands' group.

//-------------------------------------------------------------------

function ExCreateCommandDemo()

{

	Application.RemoveCommand("XYZ");

	var cmd = Application.CreateCommand("XYZ");

	cmd.Description = "XYZ custom command.";

	cmd.ScriptingName = "XYZ";

	cmd.Handler = "OnXYZCommand";

	cmd.FileName = filename;

	cmd.Language = "JScript";

	cmd.Arguments.Add( "argument0" );

	Application.AddCommand( cmd );

	// call command

	XYZ( "this is a string argument" );

}

// This sample defines the XYZ command's function handler"

function OnXYZCommand( in_arg )

{

	LogMessage( "Executing XYZ command with the argument: " + in_arg );

}

//--------------------------------------------------------------------

// Code to bootstrap example into system

//--------------------------------------------------------------------

function ExampleSourceCode()

{

	return "//XSISDK Doc Example\n" +

		OnXYZCommand.toString();

}

// if we are running from script editor save code to 

// examples addon folder in the user's directory.

if (GetUserPref("ScriptingSessionActive"))

{

	var ex_name 		= "ExXSIApplicationCreateCommand";

	var ex_subfolder 	= "Scripts";

	var ex_folder 		= "XSISDKDocExamples";

	var ex_langsuffix	= ".js";

	CreateAddonDirectories( InstallationPath(siUserPath), ex_folder );

	var fso = XSIFactory.CreateActiveXObject("Scripting.FileSystemObject");

	var filename = XSIUtils.BuildPath( 

		InstallationPath(siUserAddonPath), 

		ex_folder,

		"Data",

		ex_subfolder,

		ex_name+ex_langsuffix );

	if (!fso.FileExists(filename))

	{

		var f = fso.CreateTextFile ( filename );

		f.write( ExampleSourceCode() );

		f.close();

	}

	// run demo

	ExCreateCommandDemo();

}