DW MX 2004 API帮助：Object篇

介绍：本文英文原版是Dreamweaver安装目录下help/dwextend.chm，由馒头(www.mantou001.com)翻译为中文，在翻译的过程中为了尽量符合我们中国人的口味，我首先考虑到语言的地道，尽量让读者忘记自己在阅读译文，其次是让读者能流畅的看懂，至于忠于原文放在第三位，为了照顾初学者，一些词语译者还加了注释，译文版权归馒头任何，转载请注明出处(www.mantou001.com).翻的不好，请多多指教。

插入对象是如何运作的？

当用户通过插入面板或通过菜单选定一个对象，这之后执行的过程如下：

1.Dreamweaver调用canInsertObject()函数判断是否显示对话框。

2.在对相对应的文档中搜索"form"(表单的意思，译者注)标记，假如存在"form"标记而且对话框显示的话，Dreamweaver调用windowDimensions()函数判断放置表单的对话框的大小，假如对应的文档中不存在"form"标记，Dreamweaver不显示对话框，跳过步骤2。

3.假如第1步中Dreamweaver显示了对话框，用户输入该对象的参数(比如表格的行数，列数)，点击确定。

4.调用objectTag()，他返回的值被插入当前的位置之后(假如当前选定了文字，将不被替换)。

5.假如Dreamweaver没找到objectTag()函数，用insertObject()函数代替。

向插入面板中添加对象

每一个对象文档关联着一个18*18像素大小出现在插入面板上的的图像。

假如您的图像大于18*18，Dreamweaver将自动转换成18*18，假如您没有图像将使用默认的图像。

要点：虽然对象文档能够存放在单独的文档夹内，但是每个文档名必须是唯一的!因为某些函数不单单在指定文家夹内搜索.比如假如有两个文档叫button.htm，Dreamweaver不能区分。

定义插入面板

插入面板的定义是通过Configurations/Objects/insertbar.xml这个文档进行的，这个文档中包含了每个对象的定义信息。

用户第一次运行Dreamweaver时插入面板在编辑区上方，此后这个面板显示不显示和现实时的位置等信息将被保存到注册表中。

下面就举例说明insertbar.xml文档的格式：

插入面板中出现的几种脚本

◆<insertbar></insertbar>
作用：文档开头结尾标志 。

◆<category></category>
作用：定义一个标签页(译者注：因为Dreamweaver插入面板上的按钮太多，因此分成许多"标签页"，比如：常用，文本等)。

例如：
<category id="DW_Insertbar_Text" folder="Text">
属性id 每一个标签页有一个唯一的 id， 比如上文的 DW_Insertbar_Common 属性。 folder 存放该标签页任何按钮的文档夹名，比如上文的 common 存放在。<insertbar></insertbar>之间 。

◆<button>
作用：定义一个按钮
例如：

属性id 每一个按钮有一个唯一的id，比如上文的DW_TagDialog。

属性image 按钮的图像的文档名。

属性file 按钮对应的文档名。

存放在<category></category>之间 。

◆<separator>
作用：定义一个状态转换栏(这样说很含糊，很难理解，请看排版标签页中的Standard View和Layout View看效果)。

存放在<category></category>之间 。

◆<checkbutton>
作用：定义一个状态转换按钮。
例如：

属性id 每一个转换按钮有一个唯一的id，比如：DW_StandardView。

属性name 按钮的名称(译者注：同时也是在Dreamweaer中显示的按钮和鼠标放上去后的提示)。

属性image 按钮图像文档，image=""表示文字按钮。

属性enabled和checked一起控制其他按钮的可用或灰掉。

放在<separator showIf=""/><separator showIf=""/>之间。