Specifications

Chapter 552
Adding objects to the Insert bar
Each Object file has an associated 18 x 18 pixel image that appears in the Insert bar.
If you create a larger object image, Dreamweaver scales it to 18 x 18 pixels. If you do not create an
image for your object, a default object icon appears in the Insert bar.
Note: Although Object files can be stored in separate folders, it’s important that each filename be unique. The
“dom.insertObject()” on page 471, for example, looks for a specified file anywhere within the Objects folder without
regard to subfolders. If a file called Button.htm exists in the Forms folder and also in the MyObjects folder,
Dreamweaver cannot distinguish between them.
Defining the Insert bar
The Insert bar is defined by the insertbar.xml file that is found in the Configurations/Objects
folder.
The XML file contains definitions for each individual object, in the order that the objects appear.
The first time that the user launches Dreamweaver, the Insert bar appears horizontally above the
document. After that, its visibility and position are saved in the registry.
The following example illustrates the format for the insertbar.xml file:
<?xml version="1.0"?>
<insertbar >
<category id="DW_Insertbar_Common" folder="Common">
<button id="DW_TagDialog"
image="Objects/Common/tagDialog.gif"
enabled="true"
showIf="_VIEW_CODE"
command="dw.getDocumentDOM().setView(’code’)"/>
<separator showIf="_VIEW_CODE"/>
<button id="DW_BR"
image="Objects/Common/BR.gif"
enabled="true"
file="Objects/Common/br.htm"/>
...
</category >
</insertbar>
Insert bar definition tags
The Insert bar has category, button, checkbutton, and separator items. The following sections
describe the tags for these items.
<insertbar>
Description
Signals the beginning of the Insert bar definition file.
Attributes
None.
Contents
The category tag and its contents.