MACROMEDIA DREAMWEAVER MX 2004-DREAMWEAVER API, Reference

Page: 269 / 486

Global document functions 269
Note: An automatic validation (defined by the
controlString
value
"auto-explicit"
or
"auto-
implicit"
) is currently available only for a Target Browser 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.
Arguments
location , message , timeout
•
The
location
argument is a string that specifies a toolbar item, or is an empty string, or is
one of the following keywords: "
top"
, "
topright"
, "
right"
, "
bottomright"
, "
bottom"
,
"
bottomleft"
, "
left"
, or "
topleft".
The tooltip is placed against the specified edge or
corner and is centered. An empty string causes it to be centered in the document. To specify a
toolbar item, use
"toolbar: toolbarID : itemID "
, where the toolbar ID and toolbar item ID
match the IDs in the toolbars.xml file.
•
The
message
argument is a string that contains the message.
•
The
timeout
argument is a number that specifies the milliseconds for which to display the
message. The default is 0. If the value is 0, the message stays indefinitely. Dreamweaver
automatically dismisses it if the user clicks it or switches documents, or if the time out expires.
000_DW_API_Print.book Page 269 Wednesday, August 20, 2003 9:14 AM