FLfile.setAttributes()

Availability

Flash MX 2004 7.2.

Usage

FLfile.setAttributes(fileURI, strAttrs)

Parameters

fileURI A string, expressed as a file:/// URI, specifying the file whose attributes you want to set.

strAttrs A string specifying values for the attribute(s) you want to set. For acceptable values for strAttrs, see the description.

Returns

A Boolean value of true if successful.

NOTE

Results are unpredictable if the file or folder doesn't exist. You should use FLfile.exists() before using this method.

Description

Method; specifies system-level attributes for the specified file.

The following values are valid for strAttrs:

N -- No specific attributes (not read-only, not hidden, and so on)

A -- Ready for archiving (Windows only)

R -- Read-only (on the Macintosh, read-only means "locked")

W -- Writable (overrides R)

H -- Hidden (Windows only)

V -- Visible (overrides H, Windows only)

If you include both R and W in strAttrs, the R is ignored and the file is set as writable. Similarly, if you pass H and V, the H is ignored and the file is set as visible.

If you want to make sure the archive attribute is not set, use this command with the N parameter before setting attributes. That is, there is no direct counterpart to A that turns off the archive attribute.

Examples

The following example sets the file mydata.txt to be read-only and hidden. It has no effect on the archive attribute.

var URI = "file:///c|/temp/mydata.txt";
if (FLfile.exists(URI)) {
    FLfile.setAttributes(URI, "RH");
}

The following example sets the file mydata.txt to be read-only and hidden. It also ensures that the archive attribute is not set.

var URI = "file:///c|/temp/mydata.txt";

if (FLfile.exists(URI)) {
    FLfile.setAttributes(URI, "N");
    FLfile.setAttributes(URI, "RH");
}