Altova StyleVision 2023 Enterprise Edition

Navigation: Programmers' Reference > Application API > Overview > Programming Languages > JScript

Start Application

The JScript below starts the application and shuts it down. If the COM object of the 32-bit StyleVision cannot be found, the code attempts to get the COM object of the 64-bit application; otherwise, an error is thrown. If an instance of the application is already running, the running instance will be returned.

Note:

For 32-bit StyleVision, the registered name, or programmatic identifier (ProgId) of the COM object is StyleVision.Application. For 64-bit StyleVision, the name is StyleVision_x64.Application. Be aware, though, that the calling program will access the CLASSES registry entries in its own registry hive, or group (32-bit or 64-bit). Therefore, if you run scripts using the standard command prompt and Windows Explorer on 64-bit Windows, the 64-bit registry entries will be accessed, which point to the 64-bit StyleVision. For this reason, if both StyleVision 32-bit and 64-bit are installed, special handling is required in order to call the 32-bit StyleVision. For example, assuming that Windows Scripting Host is the calling program, do the following:

1.Change the current directory to C:\Windows\SysWOW64.

2.At the command line, type wscript.exe followed by the path to the script that you would like to run, for example:

wscript.exe "C:\Users\...\Documents\Altova\StyleVision2023\StyleVisionExamples\API\JScript\start.js"

// Initialize application's COM object. This will start a new instance of the application and
// return its main COM object. Depending on COM settings, the main COM object of an already
// running application might be returned.
try { objStyleVision = WScript.GetObject("", "StyleVision.Application"); }
catch(err) {}

if( typeof( objStyleVision ) == "undefined" )
{
try { objStyleVision = WScript.GetObject("", "StyleVision_x64.Application") }
catch(err)
{
WScript.Echo( "Can't access or create StyleVision.Application" );
WScript.Quit();
}
}

// if newly started, the application will start without its UI visible. Set it to visible.
objStyleVision.Visible = true;

WScript.Echo(objStyleVision.Edition + " has successfully started. ");

objStyleVision.Visible = false; // will shutdown application if it has no more COM connections
//objStyleVision.Visible = true; // will keep application running with UI visible

The JScript code listed above is available in the sample file Start.js (see Example Files).