User Guide

72 Chapter 6: Flash Integration
Adding a Flash element to the Insert Bar
As with other objects, you add a Flash element to the Insert Bar using the
button tag. However, a
button tag for a Flash element must have both file and command attributes to add the element
successfully to the document (see the button tag details in “Insert Bar Objects” in Extending
Dreamweaver). Use the
file attribute to tell Dreamweaver where the source file for the element
resides relative to the Objects folder. Then, use the
command attribute to tell Dreamweaver to use
the
dom.insertFlashElement() function when the user clicks the button on the Insert bar.
The following example shows the code to place in the inserbar.xml file (either as a child of the
appropriate
category or menubutton tag, depending on where you want the Flash element
button to appear):
<button id="FlashElement_Nav"
name="Navigation"
file="FlashElements\nav.swc"
command="dw.getDocumentDOM().insertFlashElement('nav.swc')" />
Note: The image on the Insert bar for the Flash element is determined within the SWC file. Also, the
button tag for a Flash element object must have a file attribute defined.
Adding a Flash Element to a menu
A Flash element can also reside on the Insert menu, or on other menus, in Dreamweaver. Use the
JavaScript function dom.insertFlashElement() with the menus.xml file format (see “Menus and
Menu Commands” in Extending Dreamweaver) to specify the Flash element menu item location.
The following example shows how code within the menus.xml file makes a Navigation Flash
element available on the Insert > Flash Element menu:
<menuitem name="Navigation"
key=""command="dw.getDocumentDOM().insertFlashElement('nav.swc')"
enabled="(dw.getFocus() != 'browser') && (dw.getDocumentDOM() != null && ¬
dw.getDocumentDOM().getParseMode() == 'html')"
id="DWMenu_Insert_FlashElement_Nav" />
The Flash Objects API
The Flash Objects API lets extension developers build objects that create simple Flash content
through Flash Generator. This API provides a way to set parameters in a Flash Generator template
and output a SWF or image file. The API lets you create new Flash objects as well as read and
manipulate existing Flash objects. The Flash button and Flash text features are built using
this API.
The SWT file is a Flash Generator Template file, which contains all the information you need to
construct a Flash Object file. These API functions let you create a new SWF file (or image file)
from a SWT file by replacing the parameters of the SWT file with real values. For more
information on Flash, see the Flash documentation. The following functions are methods of the
SWFFile object.
000_DW_API_Print.book Page 72 Wednesday, August 20, 2003 9:14 AM