The Insert Bar Definition File; Insertbar.xml Tag Hierarchy - MACROMEDIA DREAMWEAVER MX 2004-EXTENDING DREAMWEAVER Manual

When a user selects an object by clicking an icon on the Insert bar or by selecting an item on the
Insert menu, the following events occur:
Dreamweaver calls the
1
dialog box.
The Object file is scanned for a
2
Inserting Objects option in the General Preferences dialog box, Dreamweaver calls the
windowDimensions()
display the form. If no form exists in the Object file, Dreamweaver does not display a dialog
box, and skips step 2.
If Dreamweaver displays a dialog box in step 1, the user enters parameters for the object (such
3
as the number of rows and columns in a table) in the dialog box text fields and clicks OK.
Dreamweaver calls the
4
after the current selection (it does not replace the current selection).
If Dreamweaver does not find the
5
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 that 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.

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 "-//Macromedia//DWExtension insertbar 5.0">
<insertbar xmlns:MMString="http://www.macromedia.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>
114 Chapter 6: Insert Bar Objects
canInsertObject()
tag. If a form exists and you select the Show Dialog When
FORM
function, if defined, to determine the size of the dialog box in which to
function and inserts its return value into the document
objectTag()
objectTag()
function to determine whether to show a
function, it looks for an
insertObject()