Adobe Extending Dreamweaver CS4 - Manual (Page 111)

105 EXTENDING DREAMWEAVER CS4
Insert bar objects
2 If Dreamweaver displays a dialog box in step 1, the user enters parameters for the object (such as the number of
rows and columns in a table) in the dialog box text fields and clicks OK.
3 Dreamweaver calls the objectTag() function and inserts its return value in the document after the current
selection. (It does not replace the current selection.)
4 If Dreamweaver does not find the objectTag() function, it looks for an insertObject() function and calls
that function instead.
The Insert bar definition file
The Configuration/Objects/insertbar.xml file defines the Insert bar properties. This XML file contains definitions for
each individual object, in the order in which the objects appear.
The first time a user starts Dreamweaver, the Insert bar appears horizontally above the document. After that, its
visibility and position are saved in the registry.
The Insertbar.xml tag hierarchy
The following example shows the format and hierarchy of nested tags in the insertbar.xml file:
<?xml version="1.0" ?>
<!DOCTYPE insertbarset SYSTEM "-//Adobe//DWExtension insertbar 10.0">
<insertbar xmlns:MMString="http://www.adobe.com/schemes/data/string/">
<category id="DW_Insertbar_Common" MMString:name="insertbar/categorycommon" folder="Common">
<button id="DW_Hyperlink" image="Common\Hyperlink.png"
MMString:name="insertbar/hyperlink" file="Common\Hyperlink.htm" />
<button id="DW_Email" image="Common\E-Mail Link.png"
MMString:name="insertbar/email" file="Common\E-Mail Link.htm" />
<separator />
<menubutton id="DW_Images" MMString:name="insertbar/images"
image="Common\Image.png">
<button id="DW_Image" image="Common\Image.png"
MMString:name="insertbar/image" file="Common\Image.htm" />
...
</menubutton>
<separator />
<button id="DW_TagChooser" MMString:name="insertbar/tagChooser"
image="Common\Tag Chooser.gif" command="dw.showTagChooser()"
codeOnly="TRUE"/>
</category>
...
</insertbar>
Note: The
insertbar and category tags use </insertbar> and </category> closing tags to denote the end of their
content. The tags button, checkbutton, and separator use a slash (/) before the closing bracket to denote the end of their
attributes and content.
Insert bar definition tags
The insertbar.xml file contains the following tags and attributes: