Adobe Extending Dreamweaver CS4 - Manual (Page 323)

317 EXTENDING DREAMWEAVER CS4
Components
Description
Dreamweaver calls this function before the Components tab appears. Dreamweaver then calls the
getSetupSteps()
function if the setupStepsCompleted() function returns zero or a positive integer.
Arguments
None.
Returns
An integer that represents the number of setup steps the user has completed, as described in the following list:
• A value of either zero or a positive integer indicates the number of completed steps.
• A value of -1 indicates that all the necessary steps are complete, so the instruction list does not appear.
handleDesignViewDrop()
Availability
Dreamweaver MX.
Description
Handles the drop operation when the user drags a table or view from the Databases panel or a component from the
Components panel to the Design view.
Arguments
componentRec
• The componentRec argument is an object that contains the following properties:
• The name property is the name of the tree node item.
• The image property is an optional icon for the tree node item. If omitted, Dreamweaver MX uses a default icon.
• The hasChildren property is a Boolean value that indicates whether the tree node item is expandable: if true,
Dreamweaver MX displays the Plus (+) and Minus (-) buttons for the tree node item; if false , the item is not
expandable.
• The toolTipText property is optional tool tip text for the tree node item.
• The isCodeViewDraggable property is a Boolean value that indicates whether the tree node item can be dragged
and dropped into the Code view.
• The isDesignViewDraggable property is a Boolean value that indicates whether the tree node item can be dragged
and dropped into the Design view.
Returns
A Boolean value that indicates whether the drop operation was successful:
true if successful; false otherwise.
Example
The following example determines if the component is a table or view, and then returns the appropriate
bHandled
value: