Adobe 38039927 Extended User Guide - Page 20

ADOBE FIREWORKS CS3 16 Extending Guide Method open(docname, bWrite) Data type string, Boolean rename(docname, newPlainFilename) string, string setFilename(docname, newPlainFilename) string, string swap(docname1, docname2) string, string Notes The first argument must be expressed as file://URL. Opens the specified file for reading or writing. If the second argument is true, the file opens for writing; otherwise it opens for reading. If the file cannot be opened, returns null; otherwise, returns a File Reference object. The docname argument is a file path or a file URL to the file that you want to rename. The newPlainFilename argument is the new name to assign to the file. The rename method returns a URL path of the newly renamed file if successful; otherwise Fireworks returns null. The first argument must be expressed as file://URL. Returns a file URL with docname replaced by newPlainFilename. For example, Files.setFilename("file:///work/logo.png", "oldlogo.png") returns "file:///work/oldlogo.png". This method does not affect the file on disk; it simply provides a convenient way to manipulate file URLs. To change the name on disk, use rename(). Each argument must be expressed as a file://URL. Swaps the contents of the two specified files, so that each file contains the contents of the other file. Only files (not directories) can be swapped, and both files must reside on the same drive. Returns true if the swap is successful; false otherwise. File Reference object The File Reference object is used to refer to a specific open file. The following table lists the methods of the File Reference object, along with their data types and, where appropriate, acceptable values and notes. Method close() readline() write(textString) Data Type none none string Notes Closes the current File Reference object. You are not required to use this method (the file is closed when the Files object is destroyed), but it is useful for controlling access to a file. Reads the next line from the current File Reference object and returns it as a string. The end-of-line character(s) are not included in the string. Returns null if end-of-file is reached or if the line is longer than 2048 characters. Writes the specified string to the current File Reference object. No end-of-line characters are appended; to include one, use "\n".