Adobe Extending Flash Professional CS5 - Manual (Page 289)

267 EXTENDING FLASH PROFESSIONAL
FLfile object
Last updated 5/2/2011
FLfile.getAttributes()
Availability
Flash MX 2004 7.2.
Usage
FLfile.getAttributes(fileOrFolderURI)
Parameters
fileOrFolderURI A string, expressed as a file:/// URI, specifying the file or folder whose attributes you want to
retrieve.
Returns
A string that represents the attributes of the specified file or folder.
Results are unpredictable if the file or folder doesn’t exist. You should use FLfile.exists() before using this method.
Description
Method; returns a string representing the attributes of the specified file or folder, or an empty string if the file has no
specific attributes (that it, it is not read-only, not hidden, and so on). You should always use
FLfile.exists() to test
for the existence of a file or folder before using this method.
Characters in the string represent the attributes as follows:
• R — fileOrFolderURI is read-only
• D — fileOrFolderURI is a folder (directory)
• H — fileOrFolderURI is hidden (Windows only)
• S — fileOrFolderURI is a system file or folder (Windows only)
• A — fileOrFolderURI is ready for archiving (Windows only)
For example, if fileOrFolderURI is a hidden folder, the string returned is "DH" .
Example
The following example gets the attributes of the file mydata.txt and displays an alert box if the file is read-only.
var URI = "file:///c|/temp/mydata.txt";
if (FLfile.exists(URI)){
var attr = FLfile.getAttributes(URI);
if (attr && (attr.indexOf("R") != -1)) { // Returned string contains R.
alert(URI + " is read only!");
}
}
See also
FLfile.setAttributes()