The Insert Bar Definition File - Adobe 38040334 - Dreamweaver CS3 User Manual

• The HTML file that defines what is inserted into a document
The head section of an Object file contains JavaScript functions (or references external JavaScript files) that process
form input from the body section and control what content is added to the user's document.The body of an Object
file can contain an HTML form that accepts parameters for the object (for example, the number of rows and columns
to insert in a table) and activates a dialog box for users to input attributes.
Note: The simplest objects contain only the HTML to insert, without
"Customizing Dreamweaver" on the Adobe Support Center.
• The 18 x 18 pixel image that appears on the Insert bar
• Additions to the insertbar.xml file. The insertbar.xml file defines where the object appears on the Insert bar.
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
canInsertObject()
The Object file is scanned for a
option in the General Preferences dialog box, Dreamweaver calls the
determine the size of the dialog box in which to 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 as the number of
2
rows and columns in a table) in the dialog box text fields and clicks OK.
Dreamweaver calls the
3
objectTag()
selection. (It does not replace the current selection.)
If Dreamweaver does not find the
4
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.
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
folder="Common">
<button id="DW
MMString:name="insertbar/hyperlink" file="Common\Hyperlink.htm" />
<button id="DW
MMString:name="insertbar/email" file="Common\E-Mail Link.htm" />
<separator />
function to determine whether to show a dialog box.
tag. If a form exists and you select the Show Dialog When Inserting Objects
form
function and inserts its return value in the document after the current
function, it looks for an
objectTag()
_
Common" MMString:name="insertbar/categorycommon"
_
Hyperlink" image="Common\Hyperlink.png"
_
Email" image="Common\E-Mail Link.png"
and tags. For more information, see
body head
function, if defined, to
windowDimensions()
function and calls that
insertObject()
DREAMWEAVER CS3
100
Extending Dreamweaver