站内搜索: 请输入搜索关键词

当前页面: 开发资料首页Javascript 专题JavaScript 使用HoTMetal

JavaScript 使用HoTMetal

摘要: JavaScript 使用HoTMetal


HotMetal PRO 6.0是强大易用的网站编辑和发布工具。在本教程中我们在HotMetal中使用JavaScript。在HotMetal中,JavaScript支持是基于HotMetal为你提供了丰富的资源以及对象。它包含了几个新的对象,比如访问DOM的对象。另外,HotMetal支持一些ActiveX控件。这些控件以及Windows脚本支持使得HotMetal成为了JavaScript设计人员一个不可多的功能强大的开发环境。

在本节教程中,你将可以学到:

怎样为按钮增加连接宏;

怎样为菜单条增加按钮;

什么样的资源适合于脚本编写;

怎样编写文档格式的脚本;

怎样编写脚本来检查上次修改的日期;

怎样编写一个保存模块脚本;

怎样识别所有的预定义的宏;

好吧,下页开始就逐个介绍。

HoTMetal中使用Javascript

1.怎样为按钮增加连接宏:

HotMetal通过宏可以支持脚本。宏可以利用工具条按钮和其它方式来进行调用,这点我们在后面的教程中将会涉及到。所有的HotMetal的宏应该存储在一个单一的文件中,比如hotmetal.mcr。这个文件是在宏文件夹SoftQuad\HotMetal PRO 6.0中。假如你已经安装了HoTMetal PRO 6.0在缺省的目录C盘下,那么你的宏文件就处在C:\Program Files\SoftQuad\HoTMetaL PRO 6.0\Macros\hotmetal.mcr中。这里要注意的是文件的扩展名为.mcr,但是它不能在HoTMetal的环境中进行编辑。你可以使用任何的文本编辑器对它进行编辑,比如Notepad等等。HotMetal PRO 6.0安装的时候为用户安装了大约20个的预定义的宏。你可以通过hotmetl.mcr文件来浏览它们。你也可以通过选择工具菜单上的Macros(宏)来找到它们。

其中一种允许宏的方法是创建一个工具条按钮并使它于宏连接上。点击按钮就触发了在宏定义了的脚本的执行。当你从试图菜单中选择了工具条,你就会看到如图1的对话框。



(图1)

图中第一个标签(Toolbars,工具条)可以让你增加、删除以及操作工具条。因为我们不想改变任何的工具条,所以这个标签现在我们暂时不使用。点击按钮(Buttons)标签,并从分类栏中选择” Application Macros(应用宏)”,这里注意新的文本对话框就会出现在右边,如图2所示:



(图2)

在列表框中的第一个宏是” Apply Layout to Document.”。让我们为它安装一个按钮到标准工具条上。
首先,为按钮选择一张图片。当你点击选择图片按钮的时候,你将可以从许多调色板中选择一张图片。一旦你点击了其中一张,你将可以得到如图3的窗口:



(图3)

在本例子中选择一个黄色的笑脸的图片,如图4所示:



(图4)

现在拖拉这个笑脸的图标到标准的工具条中,或者其它的工具条。关闭工具条和菜单定制对话框。这是新的按钮就会出现在标准的工具条中或者其它你选择的工具条。下面是扩展了的标准工具条视图,如图5所示:



(图5)

现在让我们试一试这个宏吧。首先打开一个HTML文件,为简单起见,这里选择D:\Program Files\SoftQuad\HoTMetaL PRO 6.0\Tutorial\samples\lesson1中的about.htm。点击HoTMetaL PRO 6.0s HTML Source View标签,并且在它们前面以空格填充向右移动,然后点击中那个笑脸按钮。这是源程序就会自动改变以反应在定制对话框中描述的版面定义。这时你将看到源泉代码返回到它的原版面格式。

<table cellSpacing=0 cellPadding=0 width=1% align=left border=0> <tr> <td><iframe border=0 name=abc src=3721-1.htm frameBorder=0 width=360 scrolling=no height=300></iframe></td> </tr> </table> 2.怎样为菜单条增加按钮
有几中方法可以运行JavaScript宏。第一种方法是将工具条的按钮与宏联系起来并且将这个按钮增加到HoTMetal的用户界面中去,这种方法在前面已经讲过了。在本节教程中将对第一种方法进行一点点变形,从对话框中将新的按钮拖拉到工具条区域,如图6所示是拖拉后的HotMetal的窗口:



(图6)

当调用工具条和菜单定制对话框的时候,一定要注意新的工具条(命名为ToolBar1)已经被创建。这个工具条标签允许你改变工具条的名字以及它的格式。一旦你创建了一个新的工具条,你就可以增加更多的按钮到里面了。

HoTMetal中使用Javascript

3.什么样的资源适合于脚本编写

当利用HotMetal PRO 6.0编写宏的时候,你可以使用以下几种资源:

预定义事件

HoTMetaL PRO 6.0定义了几个事件以及特殊的用户定义的宏来处理它们。这些宏应该根基HoTMetal的指令来命名的。比如,宏On_Application_Open是在每次HoTMetal PRO 6.0打开的时候被调用的。用户需要定义这个宏并将它增加到Macro/hotmetal.mcr文件中。我们在本教程中将涉及到所有的特殊的宏。

通用的文档编辑界面

总共有8个界面模拟HoTMetal 图形用户界面,如下:

Application

Document

Documents

DocumentProperty

DocumentProperties

Selection

Range

Font

文档对象模型

HoTMetal是使用Document Object Model (DOM,文档对象模型)的。DOM是一个标准的模型用于访问网页中元素。

命令条界面

HotMetal为它的菜单条提供了界面,这跟用户定义的菜单条类似。

COM 对象

HoTMetaL PRO 6.0支持三个COM对象,这三个对象定义在HMExtras.dll中:

HMExtras.fileDlg 可以让你访问文件对话框,它有丰富的命令(比如Save、SaveAS等等);

HMExtras.buttonMaker 可以使用户创建新的菜单按钮 ;

HMExtras.colorChooser 可以使用户选择菜单条颜色。

4. 怎样编写文档格式的脚本

下面举个宏的例子:根据预定义的页面的布置准则来格式化文档。为了观察这个宏的效应,请关闭Enable Source Layout(允许源程序布局)按钮,具体从菜单中选择Tools(工具)->Customization(定制)。我们首先打开应用程序来初始化一些全局的变量。另外宏的名字必须为n_Application_Open,具体的代码如下:


var viewWYSIWYG = 0;

var viewTagsOn = 1;

var viewSource = 2;

]]>


这个宏必须在打开HoTMetaL应用程序的时候才被调用。它唯一的目的就是定义三个常数,这些常数用于其它的宏。这些常数只是代表了三个相应的HoTMetaL视图。操作HoTMetaL的编辑窗口的左边按钮边角上的窗口标签,你可以看到WYSIWYG(即所见即所得)视图,TagsOn视图和源程序视图。

下面得宏是检查当前视图是否是源视图并且根据预定义的准则格式化整个文档。如果视觉图不是源视图,一个消息就会打印出来显示给用户,并且告诉用户切换视图,代码如下:




if (ActiveDocument.ViewType == viewSource) {

ActiveDocument.Layout();

}

else {

Application.Alert(Applying source layout only works in source view.\nSwitch to source view and try again.);

}

]]>


这里要注意,我们在这里已经使用了两个HotMetaL的对象:ActiveDocument 和 Application。这个Layout()方法格式化了当前文档。而Alert()方法弹出了一个警告方框。
好吧,现在让我们来测试一下这个宏。请在HotTMetaL中打开一个文档并将视图切换到源程序视图。你可以在ProgGuide目录中选择其中一段。并且通过使用Tools(工具)->Customization(定制)关闭Enable Source Layout按钮。接着将其中一行用加入空格往右移,再从工具菜单中调用宏对话框。这时会展现出定义在HotMetaL.mcr文件的宏的列表。然后运行Refresh Macros宏来装载你刚才编辑的新的宏。你将会看到Format Current Document (格式当前文档)宏。你可以运行它并且注意那个缩进的行回到它的原位置。接下来我们测试一下Alert()方法。现在将视图切换到TagsOn视图并再次运行宏,会弹出如图1的对话框:



(图1)

现在假设你想格式化文档中所选择的部分。这个请求的宏(称为Format Current Selection)跟上面所述的宏(Format Current Document)很类似。它们之间的不同只是在:Format Current Document中 Layout()方法是操作ActiveDocument 对象,而Format Current Selection中 Layout()方法是操作Selection对象:




if (ActiveDocument.ViewType == viewSource) {

Selection.Layout();

} else{

Application.Alert(Applying source layout only works in source view.\nSwitch to source view and try again.);

}

]]>

下面让我们好好看看上面这个宏是如何工作的。我们在打开的文档中缩进了两行。第一行是以”does not specify”开头的,而另外一句是以referred to in this ma:开头的。如图2所示:



(图2)

现在我们选择三行,这三行包括了以does not specify:开头的行,如图3所示:



(图3)

最后我们点击中在窗口左上角上的绿色箭头,接着宏的名字(Format Current Selection)就显示在下拉菜单的窗口中,如图4所示:



(图4)

值得一提的是,被选择的行已经被格式化为原来的段落边界。以referred to in this ma为开头的第二行保持缩进状态而没有被格式化。

5.怎样编写脚本来检查上次修改的日期

在本节教程中你将可以学到怎样编写一个宏来检查是否有任何的程序已经利用HoTMetaL中修改过一个文件。这个宏包括了以下几个检查的更新特性:On_Document_Open_Complete、On_Document_Activate和 On_Application_Activate。在前面的教程中,这些宏的名字已经被预定义了,所以这里不能对它们进行修改。这些名字指定了事件来触发宏。这个event-macro关联是隐含的,所以不能通过任何手段来对它进行改写。当我们打开一个文档的时候,比如On_Document_Open_Complete,它总是在完成文件打开的时候被调用的。以下是具体的定义:
var name = ActiveDocument.LocalFullName;

if (Application.ReadableFileExists(name)) { // if document has never been saved, do nothing

Application.Run(On_Document_Save);

}

]]>


我们首先提取当前文件夹的文件名:name = ActiveDocument.LocalFullName,然后检查可读的文件是否存在;接着我们运行宏On_Document_Save,这个宏On_Document_Save示范了微软的FileSystemObject作为ActiveX控件的使用方法,这是一个在JavaScript中。这个宏的主要思想是更新文档的LastMod属性以反应磁盘上文档的当前事件:

![CDATA[

var fso = new ActiveXObject(Scripting.FileSystemObject);

var f = fso.GetFile(ActiveDocument.LocalFullName);

var mod = Date.parse(f.DateLastModified);

var props = ActiveDocument.CustomDocumentProperties;

if (props.count != 0) {

props.Add(LastMod, mod);

}

]]>


这个宏从FileSystemObject创建了一个ActiveX控件,它包括了微软的脚本库: var fso = new ActiveXObject(Scripting.FileSystemObject);

我们可以通过以下的语句来从磁盘得到文件的属性:f = fso.GetFile(name),然后提取出文件最后一次修改的事件:mod = Date.parse(f.DateLastModified)。我们通过调用ActiveDocument的CustomDocumentProperties 属性来创建了一个用户定义的属性集:props。然后我们利用mod属性来对这个集进行初始化,这时它的数值为LastMode。

HoTMetal中使用Javascript

5.怎样编写脚本来检查上次修改的日期

这个On_Document_Activate宏是检查磁盘上的文件是否有与利用HoTMetaL编辑的当前文档相同的上次修改的日期。它提示用户该做什么以防日期不匹配。以下是这个宏的具体代码:


desc=Runs Macro: Hide_On_Document_Activate>
// Do this for local documents only

if (ActiveDocument.FullName == ActiveDocument.LocalFullName) {

var name = ActiveDocument.LocalFullName;

if (Application.ReadableFileExists(name)) { // if document has never been saved, do nothing

var fso = new ActiveXObject(Scripting.FileSystemObject);

var f = fso.GetFile(name);

var newMod = Date.parse(f.DateLastModified);

var props = ActiveDocument.CustomDocumentProperties;

if (props.count != 0) {

oldMod = props.Item(LastMod).value;

if (oldMod != newMod) {

var Yes = 6;

var No = 7;

var msg = The disk version of this document has changed from the\n;

msg += version in memory. Do you want to re-open the document?;

var ret = Application.MessageBox(msg, 36, Document Changed);

if (ret == Yes) {

ActiveDocument.Reload();

}

// Reset the timestamp regardless of the users response

// This will prevent the dialog from always showing

Application.Run(On_Document_Open_Complete);

}

}

}

}

]]>


我们再检查文件是否装载了: ActiveDocument.FullName == ActiveDocument.LocalFullName。然后我们验证一下文件是否被保存到磁盘中: Application.ReadableFileExists(name). 类似于前面的On_Document_Open_Complete 宏,我们创建一个ActiveX控件并且提取出文件的上次修改的日期,代码如下:

var fso = new ActiveXObject(Scripting.FileSystemObject);

var f = fso.GetFile(name);

var newMod = Date.parse(f.DateLastModified);
HoTMetal中使用Javascript

5.怎样编写脚本来检查上次修改的日期

接着,我们调用当前文档的定制属性集:props = ActiveDocument.CustomDocumentProperties 并且检查这个属性的数字是否不等于零。我们已经在前面的On_Document_Open_Complete 宏中已经保存了,并将它赋值给oldMod:

oldMod = props.Item(LastMod).value

当我们发现oldMod (来自打开的文档) and newMod (来自磁盘)之间的矛盾的时候,我们应该告诉用户是否从磁盘上转载了这个文件:

var Yes = 6;

var No = 7;

var msg = The disk version of this document has changed from the\n;

msg += version in memory. Do you want to re-open the document?;

var ret = Application.MessageBox(msg, 36, Document Changed);

if (ret == Yes) {

ActiveDocument.Reload();

}

最后,我们通过模仿打开的操作来重置当前文档的日期:

Application.Run(On_Document_Open_Complete);

我们想扩展这个更新特性的检查并触发它,而不管在这个文档是当前的还是当这个应用程序是当前的。这时我们可以定义On_Application_Activate宏,这个宏只是调用上面的宏:


Application.Run(On_Document_Activate);

]]>


现在我们需要复制On_Document_Save功能到On_Document_SaveAs宏:

![CDATA[

Application.Run(On_Document_Save);

]]>


最后还是对它进行一下测试吧。先在HotMetaL PRO 6.0中打开一个文档。并在你喜欢的编辑器中打开相同的文档。并在任何地方插入一个空格符再将它保存到磁盘中。当你切换到HoTMetaL应用程序,你将可以得到如图1的信息。



(图1)

6.怎样编写一个保存模块脚本

在本节教程的例子中,我们创建了一个新的保存模块文件对话框。HoTMetaL里面有几个模板你可以从中进行选择。模板只是一个普通的网页,这个网页被保存HoTMetaL应用程序目录的Template模板中。当你从文件菜单中选择新项目的时候,其中一个标签选项是Page From Template。当你选择了它,就会弹出一个标签对话框,上面包含了各种模板: General、 WebTV、 W3C、 Frame Pages、 Layout。

你可以通过保存当前文件到Template目录下的一个目录来创建一个新的模板。下面的宏,即Save As 模板,向你展示了怎样使用HMExtras.FileDlg的DisplayFileDlg方法创建一个Save As对话框。这个对话框使用Template目录作为缺省的位置,以下是详细的代码:


var obj = new ActiveXObject(HMExtras.FileDlg);

var filter = Web Page Template (*.htm, *.html)|*.htm;*.html|All Files (*.*)|*.*||;

if (obj.DisplayFileDlg(0, File Save As, filter, Application.Path + \\Template)) {

ActiveDocument.SaveAs(obj.FullPathName, true); // save and put on recent file list

}

]]>


下面解释一下上面的代码:首先,我们利用HMExtras库的FileDlg COM对象来创建一个ActiveX 控件:

var obj = new ActiveXObject(HMExtras.FileDlg);

接着利用几个条目来创建一个过滤器:

var filter = Web Page Template (*.htm, *.html)|*.htm;*.html|All Files (*.*)|*.*||;

然后我们通过调用obj.DisplayFileDlg来显示文件对话框,最后我们在如果对话框存在的时候保存文件。
HoTMetal中使用Javascript

6.怎样编写一个保存模块脚本

让我们增加第一个Save As 模板宏到文件菜单中。你可以点击文件菜单条并选择定制。接着选择菜单标签并导航到你想增加新的宏的地方去。点击Add Submenu(增加子菜单)按钮并填充缺少的项。对话框如图1所示。



(图1)

下面我们测试一下这个菜单项以及宏是如何工作的。拉下文件菜单,你可以看到多了一个Save模板项,点击它,你可以得到如图2的对话框:



找到你希望保存文件的目录并给出文件名字,点击Save按钮确认。

7. 怎样识别所有的预定义的宏

HoTMetaL PRO 6.0定义了几个内部的事件,这些事件可以触发相应的宏。这些宏为:

OnAction :当相应的菜单被点击中时,这个宏被触发;

On_Application_Activate:当HoTMetaL在从磁盘装载后或者在你运行其它应用程序之后变为激活状态的时候,这个宏被触发;

On_Application_Deactivate:当你运行其它应用程序的时候,这个宏被触发;

On_Application_Open:当你打开HoTMetaL的时候,这个宏被触发;

On_Application_Close:当你关闭HoTMetaL的时候,这个宏被触发;

On_Before_Document_Save:当你保存一个文件的时候,这个宏被触发; 这个宏是在保存文件完成之前被运行的。

On_Before_Document_SaveAs :当你SaveAs(另存为)一个文档的时候,这个宏被触发;这个宏是在SaveAS完成之前运行的。

On_Document_Activate :当文档激活的时候,这个宏被触发;

On_Document_Deactivate:当文档没被激活的时候,这个宏被触发;

On_Document_Open_Complete:当用户打开文档案并在打开操作完成的时候,这个宏被触发;

On_Document_Close:当你关闭文档的时候,这个宏被触发;

On_Document_Save:当你保存文档的时候,这个宏被触发;

On_Document_SaveAs:当你SaveAs文档的时候,这个宏被触发;

On_Update_UI :当UI被更新的时候,这个宏被触发。



↑返回目录
前一篇: 使用JavaScript中的OLE Automation
后一篇: JavaScript 数组