Adobe Dreamweaver API Reference CS5 - Manual (Page 271)

266 DREAMWEAVER API REFERENCE
Document
Last updated 8/27/2013
• If the controlString argument is "auto-explicit" , Dreamweaver prompts the user to save an unsaved
document before running the validation.
• If the controlString argument is "auto-implicit" , the validation fails without notifying the user that the
current document is unsaved.
Note: An automatic validation (that the
controlString value "auto-explicit" or "auto-implicit" defines) is
currently available only for a browser compatibility check.
• The bOpenResultsWindow argument is an optional Boolean value: true opens the Validation results window;
false otherwise. The default value is true .
• The bShowInfoMessage argument is used only when the controlString argument is defined as "auto-explicit" or
"auto-implicit" . The bShowInfoMessage argument is a Boolean value: true shows an informational message
under the toolbar item, DW_ValidatorErrors , with the number of errors found; false displays nothing. The
default value is false .
Returns
The Validation results window object.
Example
The following example runs a regular validation when the user selects the File > Check Page > Validate Markup menu
option (or Validate Current Document in the Validation panel):
dw.getDocumentDOM().runValidation('');
The following example prompts the user to save an unsaved document, runs an automatic validation, does not open
the Validation results window, but does show the total number of errors over the document toolbar button for
DW_ValidatorErrors:
dw.getDocumentDOM().runValidation('auto-explicit', false, true);
The following example does not prompt the user to save an unsaved document. If the document has not been saved,
the validation will not start. If the document has been saved, Dreamweaver runs an automatic validation, does not
open the Validation results window, and does not indicate the total number of errors encountered on the document
toolbar:
dw.getDocumentDOM().runValidation('auto-implicit', false);
dom.showInfoMessagePopup()
Availability
Dreamweaver MX 2004.
Description
Shows a tooltip-like message in the document window or under a toolbar item.