The Allaire visual tools -- HomeSite, ColdFusion Studio, and JRun Studio -- expose an Object Model, enabling developers to manipulate program functionality from external applications. In addition, power users can create scripts using JScript or VBScript and execute them from within the visual tools environments to automate tasks.
The internal scripting feature requires Microsoft's ActiveScripting engine v3.1 or later, also known as Windows Script. The engine is not installed with the Allaire visual tools. If you have Microsoft Internet Explorer 4.0 or later on your system, then you have the correct ActiveScripting engine installed. Otherwise, you need to download it from http://www.microsoft.com/msdownload/vbscript/scripting.asp.
For a script to be executable from within the visual tools, it must contain a Main routine. In JScript, create a function Main, in VBScript, create a Sub Main. Without this routine, the script fails.
The program determines which language engine to use based on the extension of the script file. If the file extension is bas, vb or vbs, then the VBScript engine is used to execute the script. Otherwise, it is assumed that the file contains JScript source.
To automate visual tools tasks, you will need to familiarize yourself with the Visual Tools Object Model. The main object is the Application object. The Application object contains two important child objects, the ActiveDocument object and the DocumentCache object. You can use these to write scripts for common tasks.
In addition, the Application object contains a number of toolbar-related functions, enabling you to create toolbars dynamically.
For best performance, you should create an Application object variable and use it throughout the script rather than continually referencing the Application object directly.
For example, using JScript:
function Main() { var app = Application; //create application object variable app.WindowState = 2; //maximize the window
}
or VBScript:
Sub Main Dim app set app = Application 'create application object variable app.WindowState = 2 'maximize the window End Sub
Note | The Application object is only available from scripts that are executed
within the visual tools. To access the Application object from an external
program, use your language's equivalent of
CreateObject("AllaireClientApp.TAllaireClientApp" ).
|
Once you have written a script, you can create a custom toolbutton to execute it from within the program. If you intend to write multiple scripts, you will want to create a toolbar for them.
![]() |
To create a toolbar for custom scripts: |
![]() |
To create a custom toolbutton: |
The toolbar displays at the top of the tab.
You can optionally create script hot keys on the Script Shortcuts tab and then click the Show keyboard shortcuts in toolbutton hints box on the Toolbars tab.
You can rearrange the buttons and add separators as needed.
Note | If the scripting engine encounters an error while executing your custom script, the script file will open in the editor with the error line highlighted. In addition, information about the error will be displayed in the status bar, helping you to debug the problem. |
In the of Keyboard Shortcuts tab of the Customization dialog, you will find a shortcut (Shift + Ctrl + Q) for the Execute current document as ActiveScript command. Executing this command passes the current document to the ActiveScripting engine, turning the program into a powerful tool for debugging your scripts. As with toolbutton-based scripts, the scripting language is determined by the file extension of the current document.