User Guide

62 Flash Integration
Inserting Flash elements
Flash elements are installed through the Extension Manager. Dreamweaver adds Flash
elements to documents in the same manner as the objects that are available on the Insert bar
or the Insert menu (for details about working with Dreamweaver objects, see “Insert Bar
Objects” in Extending Dreamweaver). By clicking on objects on the Insert bar or selecting
menu options from the Insert menu, users can add strings of code to documents. Flash
elements are available to users through the Insert bar or the Insert menu (meaning you can
add a valid Flash element file that is already installed in the Configuration/Objects/
FlashElements folder or one of its subfolders to the Insert bar or Insert menu). Extension
developers can use the JavaScript function dom.insertFlashElement() in the object definition
file to add available Flash elements to a document. When the user selects the Flash element
object, Dreamweaver unpacks the SWC file, which contains Flash content (SWF file) and a
file that details the parameters the user can edit. Dreamweaver then inserts the SWF file into
the user’s document.
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.
000_DW_API_Print.book Page 62 Wednesday, July 20, 2005 11:58 AM