Specifications

Chapter 558
isDomRequired()
Description
Determines whether the object requires a valid DOM to operate. If this function returns true or
if the function is not defined, Dreamweaver assumes that the command requires a valid DOM
and synchronizes the Code and Design views for the document before executing.
Synchronization causes all edits in the Code view to be updated in the Design view.
Arguments
None.
Returns
Dreamweaver expects true if a command requires a valid DOM to operate; false otherwise.
insertObject()
Availability
Dreamweaver MX
Description
Required if objectTag() is not defined. Called when the user clicks OK; either inserts code into
the user’s document and dismisses the dialog box, or displays an error message and leaves the
dialog box open. This works as an alternate function to use in objects instead of
objectTag(). It
does not assume that the user is inserting text at the current insertion point and allows for data
validation when the user clicks OK. You should use
insertObject() if one of the following
conditions exists:
• You need to insert code in more than one place.
• You need to insert code somewhere other than the insertion point.
• You need to validate input before inserting.
If none of these conditions apply, use
objectTag().
Arguments
None.
Returns
Dreamweaver expects a string that contains an error message or an empty string. If it returns an
empty string, the Object dialog box closes when the user clicks OK. If it is not empty,
Dreamweaver displays the error message and the dialog box remains.
Enabler
canInsertObject()