Insert object functions handle operations related to the objects on the Insert bar or listed on the Insert menu.

dreamweaver.objectPalette.getMenuDefault()

Availability

Dreamweaver MX 2004.

Description

Retrieves the ID string of the default item for the associated menu.

Arguments

menuId

  • The menuId argument is the string that defines the menu in the insertbar.xml file.

Returns

A string value defining the ID of the default item.

Example

The following example assigns the current default object for the Media menu to the defID variable:

 var defId = dw.objectPalette.getMenuDefault("DW_Media");

dreamweaver.objectPalette.setMenuDefault()

Availability

Dreamweaver MX 2004.

Description

Sets the default object for a pop-up menu. The default object’s icon represents the specified pop-up menu on the Insert bar. The user can click on the default object to insert it, or click on the arrow beside the default object to open the pop-up menu and see the other objects in that menu. Dreamweaver sets the new menu default the next time the user opens Dreamweaver or uses the Reload Extensions command.

Arguments

menuId, defaultId

  • The menuId argument is the string that defines the menu in the insertbar.xml file.

  • The defaultId argument is the string that defines the new default object in the insertbar.xml field.

Returns

A Boolean value: true if the new default is successfully set; false otherwise.

Example

The following example sets the Flash object as the default object for the Media menu:

 dw.objectPalette.setMenuDefault("DW_Media", "DW_Flash");

dreamweaver.reloadObjects()

Availability

Dreamweaver MX 2004.

Description

Reloads all the objects on the Insert bar. This function is the equivalent of Control+left-clicking the mouse on the Categories menu on the Insert bar and selecting the Reload Extensions menu option.

Arguments

None.

Returns

A Boolean value: true if the objects were successfully loaded; false otherwise.

dom.convertActiveContent()

Availability

Dreamweaver CS3.

Description

Converts all the active content in the given document.

Arguments

forceUpdate

  • The forceUpdate argument is a Boolean value that indicates whether to override the user’s preference settings (true, = override). This argument is optional.

Returns

A Boolean value: true if all active content was converted successfully. Returns false if some active content that needed to be converted was not converted, such as object tags in a locked region of a template instance.

Example

 if( !dom.convertActiveContent(true) ) { 
alert(dw.loadString("ActiveContent/notAllConverted")); 
}

dom.convertNextActiveContent()

Availability

Dreamweaver CS3.

Description

Specifies that the next object tag that is inserted (for the remainder of the current edit—one undoable action) has a script built for it. This function allows you to use a third-party extension to generate the appropriate script for the specific active content.

Arguments

None.

Returns

Nothing.

Example

 dom.convertNextActiveContent(); 
dom.insertHTML("<object classid=\"clsid:D27CDB6E-AE6D-11cf-96B8-444553540000\" codebase=\ 
"http://download.Macromedia.com/pub/shockwave/cabs/flash/swflash.cab#version=7,0,19,0\" 
width=\"100\" height=\"22\"><param name=\"movie\" value=\"button1.swf\" /><param name=\ 
"quality\" value=\"high\" /><embed src=\"button1.swf\" quality=\"high\" pluginspage=\ 
"http://www.Macromedia.com/go/getflashplayer\" type=\"application/ 
x-shockwave-flash\"width=\"100\" height=\"22\"></embed></object>\");

This work is licensed under a Creative Commons Attribution-Noncommercial-Share Alike 3.0 Unported License  Twitter™ and Facebook posts are not covered under the terms of Creative Commons.

Legal Notices   |   Online Privacy Policy