Enablers

 < Day Day Up > 

The enabler functions in the JavaScript API include the following functions.

dom.canAlign()

Availability

Dreamweaver 3.

Description

Checks whether Dreamweaver can perform an Align Left, Align Right, Align Top, or Align Bottom operation.

Arguments

None.

Returns

A Boolean value that indicates whether two or more layers or hotspots are selected.

dom.canApplyTemplate()

Availability

Dreamweaver 3.

Description

Checks whether Dreamweaver can perform an Apply To Page operation. This function is valid only for the active document.

Arguments

None.

Returns

A Boolean value that indicates whether the document is not a library item or a template, and that the selection is not within the NOFRAMES tag.

dom.canArrange()

Availability

Dreamweaver 3.

Description

Checks whether Dreamweaver can perform a Bring to Front or Move to Back operation.

Arguments

None.

Returns

A Boolean value that indicates whether a hotspot is selected.

dom.canClipCopyText()

Availability

Dreamweaver 3.

Description

Checks whether Dreamweaver can perform a Copy as Text operation.

Arguments

None.

Returns

A Boolean value: TRue if the opening and closing offsets of the selection are different; false otherwise, to indicate that nothing has been selected.

dom.canClipPaste()

Availability

Dreamweaver 3.

Description

Checks whether Dreamweaver can perform a Paste operation.

Arguments

None.

Returns

A Boolean value: TRue if the Clipboard contains any content that can be pasted into Dreamweaver; false otherwise.

dom.canClipPasteText()

Availability

Dreamweaver 3.

Description

Checks whether Dreamweaver can perform a Paste as Text operation.

Arguments

None.

Returns

A Boolean value: true if the Clipboard contains any content that can be pasted into Dreamweaver as text; false otherwise.

dom.canConvertLayersToTable()

Availability

Dreamweaver 3.

Description

Checks whether Dreamweaver can perform a Convert Layers to Table operation.

Arguments

None.

Returns

A Boolean value: true if all the content in the BODY section of the document is contained within layers; false otherwise.

dom.canConvertTablesToLayers()

Availability

Dreamweaver 3.

Description

Checks whether Dreamweaver can perform a Convert Tables to Layers operation.

Arguments

None.

Returns

A Boolean value: TRue if all the content in the BODY section of the document is contained within tables, and the document is not based on a template; false otherwise.

dom.canDecreaseColspan()

Availability

Dreamweaver 3.

Description

Checks whether Dreamweaver can perform a Decrease Colspan operation.

Arguments

None.

Returns

A Boolean value: true if the current cell has a COLSPAN attribute and that attribute's value is greater than or equal to 2; false otherwise.

dom.canDecreaseRowspan()

Availability

Dreamweaver 3.

Description

Checks whether Dreamweaver can perform a Decrease Rowspan operation.

Arguments

None.

Returns

A Boolean value: true if the current cell has a ROWSPAN attribute and that attribute's value is greater than or equal to 2; false otherwise.

dom.canDeleteTableColumn()

Availability

Dreamweaver 3.

Description

Checks whether Dreamweaver can perform a Delete Column operation.

Arguments

None.

Returns

A Boolean value: true if the insertion point is inside a cell or if a cell or column is selected; false otherwise.

dom.canDeleteTableRow()

Availability

Dreamweaver 3.

Description

Checks whether Dreamweaver can perform a Delete Row operation.

Arguments

None.

Returns

A Boolean value: TRue if the insertion point is inside a cell or if a cell or row is selected; false otherwise.

site.canEditColumns()

Description

Checks whether a site exists.

Arguments

None.

Returns

A Boolean value: true if a site exists; false otherwise.

dom.canEditNoFramesContent()

Availability

Dreamweaver 3.

Description

Checks whether Dreamweaver can perform an Edit No Frames Content operation.

Arguments

None.

Returns

A Boolean value: true if the current document is a frameset or within a frameset; false otherwise.

dom.canIncreaseColspan()

Availability

Dreamweaver 3.

Description

Checks whether Dreamweaver can perform an Increase Colspan operation.

Arguments

None.

Returns

A Boolean value: true if there are any cells to the right of the current cell; false otherwise.

dom.canIncreaseRowspan()

Availability

Dreamweaver 3.

Description

Checks whether Dreamweaver can perform an Increase Rowspan operation.

Arguments

None.

Returns

A Boolean value: true if there are any cells below the current cell; false otherwise.

dom.canInsertTableColumns()

Availability

Dreamweaver 3.

Description

Checks whether Dreamweaver can perform an Insert Column(s) operation.

Arguments

None.

Returns

A Boolean value: TRue if the selection is inside a table; false if the selection is an entire table or is not inside a table.

dom.canInsertTableRows()

Availability

Dreamweaver 3.

Description

Checks whether Dreamweaver can perform an Insert Row(s) operation.

Arguments

None.

Returns

A Boolean value: true if the selection is inside a table; false if the selection is an entire table or is not inside a table.

dom.canMakeNewEditableRegion()

Availability

Dreamweaver 3.

Description

Checks whether Dreamweaver can perform a New Editable Region operation.

Arguments

None.

Returns

A Boolean value: true if the current document is a template (DWT) file.

dom.canMarkSelectionAsEditable()

Availability

Dreamweaver 3.

Description

Checks whether Dreamweaver can perform a Mark Selection as Editable operation.

Arguments

None.

Returns

A Boolean value: true if there is a selection and the current document is a DWT file; false otherwise.

dom.canMergeTableCells()

Availability

Dreamweaver 3.

Description

Checks whether Dreamweaver can perform a Merge Cells operation.

Arguments

None.

Returns

A Boolean value: TRue if the selection is an adjacent grouping of table cells; false otherwise.

dom.canPlayPlugin()

Availability

Dreamweaver 3.

Description

Checks whether Dreamweaver can perform a Play operation. This function is valid only for the active document.

Arguments

None.

Returns

A Boolean value: TRue if the selection can be played with a plug-in.

dom.canRedo()

Availability

Dreamweaver 3.

Description

Checks whether Dreamweaver can perform a Redo operation.

Arguments

None.

Returns

A Boolean value: TRue if any steps remain to redo; false otherwise.

dom.canRemoveEditableRegion()

Availability

Dreamweaver 3.

Description

Checks whether Dreamweaver can perform an Unmark Editable Region operation.

Arguments

None.

Returns

A Boolean value: true if the current document is a template; false otherwise.

dom.canSelectTable()

Availability

Dreamweaver 3.

Description

Checks whether Dreamweaver can perform a Select Table operation.

Arguments

None.

Returns

A Boolean value: TRue if the insertion point or selection is within a table; false otherwise.

dom.canSetLinkHref()

Availability

Dreamweaver 3.

Description

Checks whether Dreamweaver can change the link around the current selection or create one if necessary.

Arguments

None.

Returns

A Boolean value: TRue if the selection is an image, text, or if the insertion point is inside a link; false otherwise. A text selection is defined as a selection for which the text Property inspector would appear.

dom.canShowListPropertiesDialog()

Availability

Dreamweaver 3.

Description

Checks whether Dreamweaver can show the List Properties dialog box.

Arguments

None.

Returns

A Boolean value: TRue if the selection is within an LI tag; false otherwise.

dom.canSplitFrame()

Availability

Dreamweaver 3.

Description

Checks whether Dreamweaver can perform a Split Frame [Left | Right | Up | Down] operation.

Arguments

None.

Returns

A Boolean value: true if the selection is within a frame; false otherwise.

dom.canSplitTableCell()

Availability

Dreamweaver 3.

Description

Checks whether Dreamweaver can perform a Split Cell operation.

Arguments

None.

Returns

A Boolean value: true if the insertion point is inside a table cell or the selection is a table cell; false otherwise.

dom.canStopPlugin()

Availability

Dreamweaver 3.

Description

Checks whether Dreamweaver can perform a Stop operation.

Arguments

None.

Returns

A Boolean value: TRue if the selection is currently being played with a plug-in; false otherwise.

dom.canUndo()

Availability

Dreamweaver 3.

Description

Checks whether Dreamweaver can perform an Undo operation.

Arguments

None.

Returns

A Boolean value: true if any steps remain to undo; false otherwise.

dom.hasTracingImage()

Availability

Dreamweaver 3.

Description

Checks whether the document has a tracing image.

Arguments

None.

Returns

A Boolean value: true if the document has a tracing image; false otherwise.

dreamweaver.assetPalette.canEdit()

Availability

Dreamweaver 4.

Description

Enables menu items in the Assets panel for editing.

Arguments

None.

Returns

Returns a Boolean value: true if the asset can be edited; false otherwise. Returns a false value for colors and URLs in the Site list, and returns a false value for a multiple selection of colors and URLs in the Favorites list.

dreamweaver.assetPalette.canInsertOrApply()

Availability

Dreamweaver 4.

Description

Checks if the selected elements can be inserted or applied. Returns either a TRue or false value so the menu items can be enabled or disabled for insertion or application.

Arguments

None.

Returns

Returns a Boolean value: TRue if the selected elements can be inserted or applied; false if the current page is a template and the current category is Templates. The function also returns a false value if no document is open or if a library item is selected in the document and the current category is Library.

dreamweaver.canClipCopy()

Availability

Dreamweaver 3.

Description

Checks whether Dreamweaver can perform a Copy operation.

Arguments

None.

Returns

A Boolean value: TRue if there is any content selected that can be copied to the Clipboard; false otherwise.

dreamweaver.canClipCut()

Availability

Dreamweaver 3.

Description

Checks whether Dreamweaver can perform a Cut operation.

Arguments

None.

Returns

A Boolean value: TRue if there is any selected content that can be cut to the Clipboard; false otherwise.

dreamweaver.canClipPaste()

Availability

Dreamweaver 3.

Description

Checks whether Dreamweaver can perform a Paste operation.

Arguments

None.

Returns

A Boolean value: true if the Clipboard contains any content that can be pasted into the current document or the active window in the Site panel (on the Macintosh, a text field in a floating panel or dialog box); false otherwise.

dreamweaver.canDeleteSelection()

Availability

Dreamweaver 3.

Description

Checks whether Dreamweaver can delete the current selection. Depending on the window that has focus, the deletion might occur in the Document window or the Site panel (on the Macintosh, in an text field in a dialog box or floating panel).

Arguments

None.

Returns

A Boolean value: TRue if the opening and closing offsets for the selection are different, which indicates that there is a selection; false if the offsets are the same, indicating that there is only an insertion point.

dreamweaver.canExportCSS()

Availability

Dreamweaver 3.

Description

Checks whether Dreamweaver can perform an Export CSS Styles operation.

Arguments

None.

Returns

A Boolean value: TRue if the document contains any class styles that are defined in the HEAD section; false otherwise.

dreamweaver.canExportTemplateDataAsXML()

Availability

Dreamweaver MX.

Description

Checks whether Dreamweaver can export the current document as XML.

Arguments

None.

Returns

A Boolean value: TRue if you can perform an export on the current document; false otherwise.

Example

The following example calls dw.canExportTemplateDataAsXML() to determine whether Dreamweaver can export the current document as XML and if it returns TRue, calls dw.ExportTemplateDataAsXML() to export it:

 if(dreamweaver.canExportTemplateDataAsXML()) {   dreamweaver.exportTemplateDataAsXML("file:///c|/dw_temps/mytemplate.txt") } 

dreamweaver.canFindNext()

Availability

Dreamweaver 3.

Description

Checks whether Dreamweaver can perform a Find Next operation.

Arguments

None.

Returns

A Boolean value: true if a search pattern has already been established; false otherwise.

dreamweaver.canFitSelection()

Availability

Dreamweaver 8.

Description

Checks whether there is a selection in an active Design view, which means that fitSelection() can be called.

Arguments

None.

Returns

A Boolean value: TRue if there is a selection in an active Design view; false otherwise.

dreamweaver.canOpenInFrame()

Availability

Dreamweaver 3.

Description

Checks whether Dreamweaver can perform an Open in Frame operation.

Arguments

None.

Returns

A Boolean value: TRue if the selection or insertion point is within a frame; false otherwise.

dreamweaver.canPasteSpecial()

Availability

Dreamweaver 8.

Description

Checks whether Dreamweaver can perform a Paste Special operation.

Arguments

None.

Returns

A Boolean value: TRue if there is text, HTML, or Dreamweaver HTML on the Clipboard and focus is in Code View, Design View, or Code Inspector; false otherwise.

dreamweaver.canPlayRecordedCommand()

Availability

Dreamweaver 3.

Description

Checks whether Dreamweaver can perform a Play Recorded Command operation.

Arguments

None.

Returns

A Boolean value: true if there is an active document and a previously recorded command that can be played; false otherwise.

dreamweaver.canPopupEditTagDialog()

Availability

Dreamweaver MX.

Description

Checks whether the current selection is a tag and whether the Edit Tag menu item is active.

Arguments

None.

Returns

The name of the currently selected tag or a null value if no tag is selected.

dreamweaver.canRedo()

Availability

Dreamweaver 3.

Description

Checks whether Dreamweaver can perform a Redo operation in the current context.

Arguments

None.

Returns

A Boolean value that indicates whether any operations can be undone.

dreamweaver.canRevertDocument()

Availability

Dreamweaver 3.

Description

Checks whether Dreamweaver can perform a Revert (to the last-saved version) operation.

Arguments

 documentObject 

  • The documentObject argument is the object at the root of a document's DOM tree (the value that the dreamweaver.getDocumentDOM() function returns).

Returns

A Boolean value that indicates whether the document is in an unsaved state and a saved version of the document exists on a local drive.

dreamweaver.canSaveAll()

Availability

Dreamweaver 3.

Description

Checks whether Dreamweaver can perform a Save All operation.

Arguments

None.

Returns

A Boolean value that indicates whether one or more unsaved documents are open.

dreamweaver.canSaveDocument()

Availability

Dreamweaver 3.

Description

Checks whether Dreamweaver can perform a Save operation on the specified document.

Arguments

 documentObject 

  • The documentObject argument is the root of a document's DOM (the same value that the dreamweaver.getDocumentDOM() function returns).

Returns

A Boolean value that indicates whether the document has any unsaved changes.

dreamweaver.canSaveDocumentAsTemplate()

Availability

Dreamweaver 3.

Description

Checks whether Dreamweaver can perform a Save As Template operation on the specified document.

Arguments

 documentObject 

  • The documentObject argument is the root of a document's DOM (the same value that the dreamweaver.getDocumentDOM() function returns).

Returns

A Boolean value that indicates whether the document can be saved as a template.

dreamweaver.canSaveFrameset()

Availability

Dreamweaver 3.

Description

Checks whether Dreamweaver can perform a Save Frameset operation on the specified document.

Arguments

 documentObject 

  • The documentObject argument is the root of a document's DOM (the same value that the dreamweaver.getDocumentDOM() function returns).

Returns

A Boolean value that indicates whether the document is a frameset with unsaved changes.

dreamweaver.canSaveFramesetAs()

Availability

Dreamweaver 3.

Description

Checks whether Dreamweaver can perform a Save Frameset As operation on the specified document.

Arguments

 documentObject 

  • The documentObject argument is the root of a document's DOM (the same value that the dreamweaver.getDocumentDOM() function returns).

Returns

A Boolean value that indicates whether the document is a frameset.

dreamweaver.canSelectAll()

Availability

Dreamweaver 3.

Description

Checks whether Dreamweaver can perform a Select All operation.

Arguments

None.

Returns

A Boolean value that indicates whether a Select All operation can be performed.

dreamweaver.canShowFindDialog()

Availability

Dreamweaver 3.

Description

Checks whether Dreamweaver can perform a Find operation.

Arguments

None.

Returns

A Boolean value that is TRue if a Site panel or a Document window is open. This function returns the value false when the selection is in the HEAD section.

dreamweaver.canUndo()

Availability

Dreamweaver 3.

Description

Checks whether Dreamweaver can perform an Undo operation in the current context.

Arguments

None.

Returns

A Boolean value that indicates whether any operations can be undone.

dreamweaver.canZoom()

Availability

Dreamweaver 8.

Description

Checks to see if there is an active Design view, which means that basic zoom commands can be applied.

Arguments

None.

Returns

A Boolean value: true if there is an active Design view; false otherwise.

dreamweaver.cssRuleTracker.canEditSelectedRule()

Availability

Dreamweaver MX 2004.

Description

Checks whether the Property Grid editor can be applied to the selected rule. Because the Property Grid can display rules in locked files, a return value of true does not guarantee that the rule can be modified.

Arguments

None.

Returns

A Boolean value: TRue if the Property Grid editor can be applied to the selected rule; false otherwise.

Example

The following code checks whether the enabler function has been set to the value TRue before allowing edits to the selected rule:

 if(dw.cssRuleTracker.canEditSelectedRule()){   dw.cssRuleTracker.editSelectedRule(); } 

dreamweaver.cssStylePalette.canApplySelectedStyle()

Availability

Dreamweaver MX.

Description

Checks the current active document to see whether the selected style can be applied.

Arguments

 { pane } 

  • The pane argument, which is optional, is a string that specifies the pane of the Styles Panel to which this function applies. Possible values are "stylelist", which is the list of styles in "All" mode; "cascade", which is the list of applicable, relevant rules in "Current" mode; "summary", which is the list of properties for the current selection in "Current" mode; and "ruleInspector", which is the editable list or grid of properties in "Current" mode. The default value is "stylelist".

Returns

A Boolean value: TRue if the selected style has a class selector; false otherwise.

dreamweaver.cssStylePalette.canDeleteSelectedStyle()

Availability

Dreamweaver MX.

Description

Checks the current selection to determine whether the selected style can be deleted.

Arguments

 { pane } 

  • The pane argument, which is optional, is a string that specifies the pane of the Styles Panel to which this function applies. Possible values are "stylelist", which is the list of styles in "All" mode; "cascade", which is the list of applicable, relevant rules in "Current" mode; "summary", which is the list of properties for the current selection in "Current" mode; and "ruleInspector", which is the editable list or grid of properties in "Current" mode. The default value is "stylelist".

Returns

A Boolean value: true if the selection can be deleted; false otherwise.

dreamweaver.cssStylePalette.canDuplicateSelectedStyle()

Availability

Dreamweaver MX.

Description

Checks the current active document to see whether the selected style can be duplicated.

Arguments

 { pane } 

  • The pane argument, which is optional, is a string that specifies the pane of the Styles Panel to which this function applies. Possible values are "stylelist", which is the list of styles in "All" mode; "cascade", which is the list of applicable, relevant rules in "Current" mode; "summary", which is the list of properties for the current selection in "Current" mode; and "ruleInspector", which is the editable list or grid of properties in "Current" mode. The default value is "stylelist".

Returns

A Boolean value: TRue if the selected style can be duplicated; false otherwise.

dreamweaver.cssStylePalette.canEditSelectedStyle()

Availability

Dreamweaver MX.

Description

Checks the current active document to see whether the selected style can be edited.

Arguments

 { pane } 

  • The pane argument, which is optional, is a string that specifies the pane of the Styles Panel to which this function applies. Possible values are "stylelist", which is the list of styles in "All" mode; "cascade", which is the list of applicable, relevant rules in "Current" mode; "summary", which is the list of properties for the current selection in "Current" mode; and "ruleInspector", which is the editable list or grid of properties in "Current" mode. The default value is "stylelist".

Returns

A Boolean value: TRue if the selected style is editable; false otherwise.

dreamweaver.cssStylePalette.canEditSelectedStyleInCodeview()

Availability

Dreamweaver MX.

Description

Checks the current active document to see whether the selected style can be edited in Code view.

Arguments

 { pane } 

  • The pane argument, which is optional, is a string that specifies the pane of the Styles Panel to which this function applies. Possible values are "stylelist", which is the list of styles in "All" mode; "cascade", which is the list of applicable, relevant rules in "Current" mode; "summary", which is the list of properties for the current selection in "Current" mode; and "ruleInspector", which is the editable list or grid of properties in "Current" mode. The default value is "stylelist".

Returns

A Boolean value: true if the selected style is editable; false otherwise.

dreamweaver.cssStylePalette.canEditStyleSheet()

Availability

Dreamweaver MX.

Description

Checks the current selection to see whether it contains style sheet elements that can be edited.

Arguments

None.

Returns

A Boolean value: TRue if the selection is a style sheet node or a style definition within a style sheet node and the style sheet is neither hidden nor this document; false if the selection is hidden or in this document.

dreamweaver.cssStylePalette.canRenameSelectedStyle()

Availability

Dreamweaver MX.

Description

Checks the current active document to see whether the selected style can be renamed.

Arguments

 { pane } 

  • The pane argument, which is optional, is a string that specifies the pane of the Styles Panel to which this function applies. Possible values are "stylelist", which is the list of styles in "All" mode; "cascade", which is the list of applicable, relevant rules in "Current" mode; "summary", which is the list of properties for the current selection in "Current" mode; and "ruleInspector", which is the editable list or grid of properties in "Current" mode. The default value is "stylelist".

Returns

A Boolean value: TRue if the selected style can be renames; false otherwise.

dreamweaver.isRecording()

Availability

Dreamweaver 3.

Description

Reports whether Dreamweaver is currently recording a command.

Arguments

None.

Returns

A Boolean value that indicates whether Dreamweaver is recording a command.

dreamweaver.htmlStylePalette.canEditSelection()

Availability

Dreamweaver 3.

Description

Checks whether Dreamweaver can edit, delete, or duplicate the selection in the HTML Styles panel.

Arguments

None.

Returns

A Boolean value: true if Dreamweaver can edit, delete, or duplicate the selection in the HTML Styles panel; false if no style is selected or if one of the clear styles is selected.

dreamweaver.resultsPalette.canClear()

Availability

Dreamweaver MX.

Description

Checks whether you can clear the contents of the Results panel that is currently in focus.

Arguments

None.

Returns

A Boolean value: TRue if the contents can clear; false otherwise.

dreamweaver.resultsPalette.canCopy()

Availability

Dreamweaver MX.

Description

Checks whether the current Results window can display a copied message in its contents.

Arguments

None.

Returns

A Boolean value: TRue if the contents can display; false otherwise.

dreamweaver.resultsPalette.canCut()

Availability

Dreamweaver MX.

Description

Checks whether the current Results window can display a Cut message in its contents.

Arguments

None.

Returns

A Boolean value: true if the contents can display; false otherwise.

dreamweaver.resultsPalette.canPaste()

Availability

Dreamweaver MX.

Description

Checks whether the current Results window can display a Paste message in its contents.

Arguments

None.

Returns

A Boolean value: true if the contents can display; false otherwise.

dreamweaver.resultsPalette.canOpenInBrowser()

Availability

Dreamweaver MX.

Description

Checks whether the current report can display in a browser.

Arguments

None.

Returns

A Boolean value: true if the contents can display; false otherwise.

dreamweaver.resultsPalette.canOpenInEditor()

Availability

Dreamweaver MX.

Description

Checks whether the current report can display in an editor.

Arguments

None.

Returns

A Boolean value: TRue if the contents can display; false otherwise.

dreamweaver.resultsPalette.canSave()

Availability

Dreamweaver MX.

Description

Checks whether the Save dialog box can open for the current panel. Currently, the Site Reports, Target Browser Check, Validation, and Link Checker panels support the Save dialog box.

Arguments

None.

Returns

A Boolean value: true if the Save dialog box can appear; false otherwise.

dreamweaver.resultsPalette.canSelectAll()

Availability

Dreamweaver MX.

Description

Checks whether a Select All message can be sent to the window that is currently in focus.

Arguments

None.

Returns

A Boolean value: true if the Select All message can be sent; false otherwise.

dreamweaver.siteSyncDialog.canCompare()

Availability

Dreamweaver 8.

Description

Ths function checks whether the Compare context menu in the Site Synchronize dialog box can be displayed.

Arguments

None.

Returns

A Boolean value: true if the Compare context menu in the Site Synchronize dialog box can be displayed; false otherwise.

dreamweaver.siteSyncDialog.canMarkDelete()

Availability

Dreamweaver 8.

Description

This function checks whether the Change Action to Delete context menu in the Site Synchronize dialog box can be displayed.

Arguments

None.

Returns

A Boolean value: TRue if the Change Action to Delete context menu can be displayed; false otherwise.

dreamweaver.siteSyncDialog.canMarkGet()

Availability

Dreamweaver 8.

Description

This function checks whether the Change Action to Get context menu in the Site Synchronize dialog box can be displayed.

Arguments

None.

Returns

A Boolean value: true if the Change Action to Get context menu can be displayed; false otherwise.

dreamweaver.siteSyncDialog.canMarkIgnore()

Availability

Dreamweaver 8.

Description

This function checks whether the Change Action to Ignore context menu in the Site Synchronize dialog box can be displayed.

Arguments

None.

Returns

A Boolean value: TRue if the Change Action to Ignore context menu can be displayed; false otherwise.

dreamweaver.siteSyncDialog.canMarkPut()

Availability

Dreamweaver 8.

Description

This function checks whether the Change Action to Put context menu in the Site Synchronize dialog box can be displayed.

Arguments

None.

Returns

A Boolean value: true if the Change Action to Put context menu can be displayed; false otherwise.

dreamweaver.siteSyncDialog.canMarkSynced()

Availability

Dreamweaver 8.

Description

This function checks whether the Change Action to Synced context menu in the Site Synchronize dialog box can be displayed.

Arguments

None.

Returns

A Boolean value: true if the Change Action to Synced context menu can be displayed; false otherwise.

dreamweaver.snippetpalette.canEditSnippet()

Availability

Dreamweaver MX.

Description

Checks whether you can edit the currently selected item and returns either a true or false value so you can enable or disable menu items for editing.

Arguments

None.

Returns

A Boolean value: TRue if you can edit the currently selected item; false otherwise.

dreamweaver.snippetpalette.canInsert()

Availability

Dreamweaver MX.

Description

Checks whether you can insert or apply the selected element and returns either a true or false value so you can enable or disable menu items for inserting or applying.

Arguments

None.

Returns

A Boolean value: TRue if you can insert or apply the selected element; false otherwise.

site.browseDocument()

Availability

Dreamweaver 4.

Description

Opens all selected documents in a browser window. It is the same as using the Preview in Browser command.

Arguments

 browserName 

  • The browserName argument is the name of a browser as defined in the Preview in Browser preferences. If omitted, this argument defaults to the user's primary browser.

Returns

Nothing.

site.canAddLink()

Availability

Dreamweaver 3.

Description

Checks whether Dreamweaver can perform an Add Link to [Existing File | New File] operation.

Arguments

None.

Returns

A Boolean value: TRue if the selected document in the site map is an HTML file; false otherwise.

site.canChangeLink()

Availability

Dreamweaver 3.

Description

Checks whether Dreamweaver can perform a Change Link operation.

Arguments

None.

Returns

A Boolean value: TRue if an HTML or Flash file links to the selected file in the site map; false otherwise.

site.canCheckIn()

Availability

Dreamweaver 3.

Description

Determines whether Dreamweaver can perform a Check In operation.

Arguments

 siteOrURL 

  • The siteOrURL argument must be the site keyword, which indicates that the function should act on the selection in the Site panel or the URL for a single file.

Returns

A Boolean value: TRue if the following conditions are true; false otherwise:

  • A remote site has been defined.

  • If a document window has focus, the file has been saved in a local site; or, if the Site panel has focus, one or more files or folders are selected.

  • The Check In/Check Out feature is turned on for the site.

site.canCheckOut()

Availability

Dreamweaver 3.

Description

Determines whether Dreamweaver can perform a Check Out operation on the specified file or files.

Arguments

 siteOrURL 

  • The siteOrURL argument must be the site keyword, which indicates that the function should act on the selection in the Site panel or the URL for a single file.

Returns

A Boolean value: TRue if all the following conditions are true; false otherwise:

  • A remote site has been defined.

  • If a document window has focus, the file is part of a local site and is not already checked out; or, if the Site panel has focus, one or more files or folders are selected and at least one of the selected files is not already checked out.

  • The Check In/Check Out feature is turned on for the site.

site.canCloak()

Availability

Dreamweaver MX.

Description

Determines whether Dreamweaver can perform a Cloaking operation.

Arguments

 siteOrURL 

  • The siteOrURL argument must be the site keyword, which indicates that the canCloak() function should act on the selection in the Site panel or the URL of a particular folder, which indicates that the canCloak() function should act on the specified folder and all its contents.

Returns

A Boolean value: true if Dreamweaver can perform the Cloaking operation on the current site or the specified folder; false otherwise.

site.canCompareFiles()

Availability

Dreamweaver 8.

Description

This function checks whether Dreamweaver can perform the Compare function on selected files.

Arguments

None.

Returns

A Boolean value: true if two files (one local file and one remote file, two local files, or two remote files) are selected; false otherwise.

site.canConnect()

Availability

Dreamweaver 3.

Description

Checks whether Dreamweaver can connect to the remote site.

Arguments

None.

Returns

A Boolean value: TRue if the current remote site is an FTP site; false otherwise.

site.canFindLinkSource()

Availability

Dreamweaver 3.

Description

Checks whether Dreamweaver can perform a Find Link Source operation.

Arguments

None.

Returns

A Boolean value that indicates that the selected link in the site map is not the home page.

site.canGet()

Availability

Dreamweaver 3.

Description

Determines whether Dreamweaver can perform a Get operation.

Arguments

 siteOrURL 

  • The siteOrURL argument must be the site keyword, which indicates that the function should act on the selection in the Site panel or the URL for a single file.

Returns

If the argument is site, a Boolean value that indicates whether one or more files or folders is selected in the Site panel and a remote site has been defined. If the argument is a URL, a Boolean value that indicates whether the document belongs to a site for which a remote site has been defined.

site.canLocateInSite()

Availability

Dreamweaver 3.

Description

Determines whether Dreamweaver can perform a Locate in Local Site or Locate in Remote Site operation (depending on the argument).

Arguments

 localOrRemote, siteOrURL 

  • The localOrRemote argument must be either local or remote.

  • The siteOrURL argument must be the site keyword, which indicates that the function should act on the selection in the Site panel or the URL for a single file.

Returns

One of the following values:

  • If the first argument is the keyword local and the second argument is a URL, a Boolean value that indicates whether the document belongs to a site

  • If the first argument is the keyword remote and the second argument is a URL, a Boolean value that indicates whether the document belongs to a site for which a remote site has been defined, and, if the server type is Local/Network, whether the drive is mounted

  • If the second argument is the keyword site, a Boolean value that indicates whether both windows contain site files (not the site map) and whether the selection is in the opposite pane from the argument

site.canMakeEditable()

Availability

Dreamweaver 3.

Description

Checks whether Dreamweaver can perform a Turn Off Read Only operation.

Arguments

None.

Returns

A Boolean value: TRue if Dreamweaver can perform a Turn Off Read Only operation; false if one or more of the selected files is locked.

site.canMakeNewFileOrFolder()

Availability

Dreamweaver 3.

Description

Checks whether Dreamweaver can perform a New File or New Folder operation in the Site panel.

Arguments

None.

Returns

A Boolean value: true if any files are visible in the selected pane of the Site panel; false otherwise.

site.canOpen()

Availability

Dreamweaver 3.

Description

Checks whether Dreamweaver can open the files or folders that are currently selected in the Site panel.

Arguments

None.

Returns

A Boolean value: true if any files or folders are selected in the Site panel; false otherwise.

site.canPut()

Availability

Dreamweaver 3.

Description

Determines whether Dreamweaver can perform a Put operation.

Arguments

 siteOrURL 

  • The siteOrURL argument must be the site keyword, which indicates that the function should act on the selection in the Site panel, or the URL for a single file.

Returns

One of the following values:

  • If the argument is the keyword site, returns the value true if any files or folders are selected in the Site panel and a remote site has been defined; otherwise false.

  • If the argument is a URL, returns the value true if the document belongs to a site for which a remote site has been defined; otherwise false.

site.canRecreateCache()

Availability

Dreamweaver 3.

Description

Checks whether Dreamweaver can perform a Recreate Site Cache operation.

Arguments

None.

Returns

A Boolean value: true if the Use Cache To Speed Link Updates option is enabled for the current site.

site.canRefresh()

Availability

Dreamweaver 3.

Description

Checks whether Dreamweaver can perform a Refresh [Local | Remote] operation.

Arguments

 localOrRemote 

  • The localOrRemote argument must be either the local or remote keyword.

Returns

A value of TRue if the localOrRemote argument is the local keyword; otherwise, a Boolean value that indicates whether a remote site has been defined.

site.canRemoveLink()

Availability

Dreamweaver 3.

Description

Checks whether Dreamweaver can perform a Remove Link operation.

Arguments

None.

Returns

A Boolean value that indicates that an HTML or Flash file links to the selected file in the site map.

site.canSetLayout()

Availability

Dreamweaver 3.

Description

Determines whether Dreamweaver can perform a Layout operation.

Arguments

None.

Returns

A Boolean value: true if the site map is visible; false otherwise.

site.canSelectAllCheckedOutFiles()

Availability

Dreamweaver 4.

Description

Determines whether the current working site has the Check In/Check Out feature enabled.

Arguments

None.

Returns

A Boolean value: true if the site allows Check In/Check Out; false otherwise.

site.canSelectNewer()

Availability

Dreamweaver 3.

Description

Determines whether Dreamweaver can perform a Select Newer [Remote | Local] operation.

Arguments

 localOrRemote 

  • The localOrRemote argument must be either the local or remote keyword.

Returns

A Boolean value that indicates whether the document belongs to a site for which a remote site has been defined.

site.canShowPageTitles()

Availability

Dreamweaver 3.

Description

Determines whether Dreamweaver can perform a Show Page Titles operation.

Arguments

None.

Returns

A Boolean value: true the site map is visible; false otherwise.

site.canSynchronize()

Availability

Dreamweaver 3.

Description

Determines whether Dreamweaver can perform a Synchronize operation.

Arguments

None.

Returns

A Boolean value that indicates whether a remote site has been defined.

site.canUncloak()

Availability

Dreamweaver MX.

Description

Determines whether Dreamweaver can perform an uncloaking operation.

Arguments

 siteOrURL 

  • The siteOrURL argument must be the site keyword, which indicates that the canUncloak() function should act on the selection in the Site panel or the URL of a particular folder, which indicates that the canUncloak() function should act on the specified folder and all its contents.

Returns

A Boolean value: true if Dreamweaver can perform the uncloaking operation on the current site or the specified folder; false otherwise.

site.canUndoCheckOut()

Availability

Dreamweaver 3.

Description

Determines whether Dreamweaver can perform an Undo Check Out operation.

Arguments

 siteOrURL 

  • The siteOrURL argument must be the site keyword, which indicates that the function should act on the selection in the Site panel or the URL for a single file.

Returns

A Boolean value: TRue if the specified file or at least one of the selected files is checked out.

site.canViewAsRoot()

Availability

Dreamweaver 3.

Description

Determines whether Dreamweaver can perform a View as Root operation.

Arguments

None.

Returns

A Boolean value: true if the specified file is an HTML or Flash file; false otherwise.

     < Day Day Up > 


    Developing Extensions for Macromedia Dreamweaver 8
    Developing Extensions for Macromedia Dreamweaver 8
    ISBN: 0321395409
    EAN: 2147483647
    Year: 2005
    Pages: 282

    flylib.com © 2008-2017.
    If you may any questions please contact us: flylib@qtcs.net