// SoftQuad Script Language JSCRIPT:
Application.Alert("Your Message Here", "Your Title");

Copies the file at strSrcFile (which can be a file at any location or a URL) to the file strDestFile. Will not overwrite an existing file unless boolForceUpdate is true, and then only if the file is writable. strDestFile can be in one of four folders (and their subfolders):

• The Assets folder
• The folder containing the active document
• The folder where documents are being opened from (the folder that the Open dialog currently displays)
• The folder where documents are being saved to (the folder that the Save As dialog currently displays)

CopyAssetFile will create folders if necessary.

// SoftQuad Script Language JSCRIPT:
var rVal;
rVal = Application.Confirm("Are you sure?", "Confirm");
Application.Alert(rVal);

Disables the macro strMacroName by disabling its shortcut key, and graying out its toolbar button and menu item (if any). The macro can still be run from the Macros dialog and Macros toolbar. This method is intended to be used only in the special On_Update_UI macro. Whenever On_Update_UI is called, any macros that were disabled the last time On_Update_UI was executed are automatically enabled again.

It is a good idea to have a macro that can be disabled in this way check for conditions that may also make it undesirable to run the macro from the Macros dialog or Macros toolbar when it is disabled. If the macro should not be run in this way, it can issue a `beep' using Application.Beep . If you know that you will never want to run it from the Macros dialog or Macros toolbar, set the macro's hide attribute to true (you should do this after you associate the macro with a toolbar and/or menu item).

<MACRO name="On_Update_UI" lang="JScript">
// SoftQuad Script Language JSCRIPT:
if (!Document.IsValid) {
   DisableMacro("SaveAsRTF");
}
</MACRO>

// SoftQuad Script Language JSCRIPT:
// disable modeless dialogs
Application.EnableModeless(false);  

// SoftQuad Script Language JSCRIPT:
var exists;
exists=Application.FileExists("c:\\data\\food.xml");

// SoftQuad Script Language JSCRIPT:
var docPath = "c:\\data\\mundo.txt";
if (Application.ReadableFileExists(docPath)) {
// This will return all the contents of the 
// file in string format
  var docToString= Application.FileToString(docPath);
} 
else {
  Application.Alert("Unable to read file.");
}

• 0: Help Contents
• 1: Search for Help on...
• 2: How to use Help
• 4: SoftQuad Home Page
• 7: About HoTMetaL...
• 8: Display help topic with context ID longContextId in the HoTMetaL PRO help file.

// SoftQuad Script Language JSCRIPT:
Application.Help(0); 
//brings up the Help Contents dialog

// SoftQuad Script Language JSCRIPT:

Application.HelpContext("hmpro6.hlp", 138);

// SoftQuad Script Language JSCRIPT:
// Open the HoTMetaL PRO help file

Application.HelpFinder("hmpro6.hlp");

Application.MessageBox(strMessage,
    longButtons, [strTitle]);

Application.MessageBox(strMessage,
    longButtons, [strTitle])

// SoftQuad Script Language JSCRIPT:
var ans = Application.MessageBox("Can't save",
    18, "Warning");
// Using the warning icon (16), and the abort, 
// retry, and ignore buttons (2), 
// we have a input parameter of 18. 
Application.Alert(ans);

// SoftQuad Script Language JSCRIPT:
var ans = Application.NoticeBox("myMessage", "Yes",
       "No", "Abort", "Proceed?");
Application.Alert(ans);

// SoftQuad Script Language JSCRIPT:
var u1, u2;
u1=Application.PathToURL("c:\\dir1\\dir2\\test.htm);
// Displays "file:///c|/dir1/dir2/test.htm"
Application.Alert(u1);
u2=Application.PathToURL("c:\\dir1\images\one.gif",
      "c:\\dir1\\dir2\\test.htm);
// Displays "..\images\one.gif"
Application.Alert(u2);

// SoftQuad Script Language JSCRIPT:

//Displays a text entry box with "Jams O'Donnell" 
// as the default entry
var you;
you=Application.Prompt("Enter your name", 
         "Jams O'Donnell");

• 0: prompt the user to save changes (the default)
• 1: save changes without prompting
• 2: do not save changes

// SoftQuad Script Language JSCRIPT:
// Quit and save all changes
Application.Quit(1); 

// SoftQuad Script Language JSCRIPT:
var readable;
var docPath = ActiveDocument.FullName;
readable = Application.ReadableFileExists(docPath);

// SoftQuad Script Language JSCRIPT:
Application.Run("macroName");

// SoftQuad Script Language JSCRIPT:
Application.RunKeyedMacro("Ctrl+Alt+G");

// SoftQuad Script Language JSCRIPT:
// Return a unique filename in C:\ that 
// begins with "b" and has the extension ".sys"
var str = Application.UniqueFileName("C:", "b", ".sys");
Application.Alert(str);

// SoftQuad Script Language JSCRIPT:
var p1, p2;
p1=Application.URLToPath("file:///c|/data/index.html");
// Displays "c:/data/index.html"
Application.Alert(p1);
p2=Application.URLToPath("../images/one.gif", 
      "d:\\dir1\\dir2\\test.htm");
// Displays "d:\dir1\images\one.gif"
Application.Alert(p2);

// SoftQuad Script Language JSCRIPT:
var exists;
var appPath = Application.Path;
exists=Application.WritableDirExists(appPath);

// SoftQuad Script Language JSCRIPT:
var docPath = ActiveDocument.FullName;
Application.Alert(Application.WritableFileExists(docPath));