Adobe 38040334 API Reference - Page 24

DREAMWEAVER CS3 19 API Reference • The callbackFunction argument is the name of the JavaScript function to call when the HTTP request is complete. • The URL argument is an absolute URL on a web server; if http:// is omitted from the URL, Dreamweaver assumes HTTP protocol. • The prompt argument, which is optional, is a Boolean value that specifies whether to prompt the user to save the file. If saveURL argument specifies a location outside the Configuration/Temp folder, a prompt value of false is ignored for security reasons. • The saveURL argument, which is optional, is the location on the user's hard disk where the file should be saved, which is expressed as a file:// URL. If prompt is a true value or saveURL is outside the Configuration/Temp folder, the user can override saveURL in the Save dialog box. • The titleBarLabel argument, which is optional, is the label that should appear in the title bar of the Save dialog box. Returns An object that represents the reply from the server. The data property of this object is a string that contains the location where the file was saved, which is expressed as a file:// URL. Normally the statusCode property of the object contains the status code that is received from the server. However, if a disk error occurs while Dreamweaver is saving the file on the local drive, the statusCode property contains an integer that represents an error code. See "MMHttp.getFile()" on page 17 for a list of possible error codes. MMHttp.getText() Availability Dreamweaver UltraDev 4, enhanced in Dreamweaver MX. Description Retrieves the contents of the document at the specified URL. Arguments URL, {serverScriptsFolder} • The URL argument is an absolute URL on a web server. If http:// is omitted from the URL, Dreamweaver assumes HTTP protocol. • The serverScriptsFolder argument is an optional string that names a particular folder-relative to the Configuration folder on the application server-from which you want to retrieve server scripts. To retrieve the scripts, Dreamweaver uses the appropriate transfer protocol (such as FTP, WebDAV, or Remote File System). Dreamweaver copies these files to the _mmServerScripts subfolder under the root folder for the current site. If an error occurs, Dreamweaver reports it in the statusCode property of the returned object. MMHttp.getTextCallback() Availability Dreamweaver UltraDev 4, enhanced in Dreamweaver MX. Description Retrieves the contents of the document at the specified URL and passes it to the specified function.