Folder

Description

Represents a file-system folder or directory in a platform-independent manner.

Properties

absoluteURI readonly The full path name for the referenced folder in URI notation.
alias readonly When true, the object refers to a file system alias or shortcut.
created readonly The creation date of the referenced folder, or null if the object does not refer to a folder on disk.
displayName readonly The localized name portion of the absolute URI for the referenced folder, without the path specification.
error readonly A message describing the most recent file system error.
exists readonly When true, this object refers to a folder that currently exists in the file system.
fsName readonly The platform-specific name of the referenced folder as a full path name.
fullName readonly The full path name for the referenced folder in URI notation. .
modified readonly The date of the referenced folder’s last modification, or null if the object does not refer to a folder on disk.
name readonly The folder name portion of the absolute URI for the referenced file, without the path specification.
parent readonly TThe Folder object for the folder that contains this folder, or null if this object refers to the root folder of a volume.
path readonly The path portion of the object absolute URI for the referenced file, without the folder name.
relativeURI readonly The path name for the referenced folder in URI notation, relative to the current folder.

Static Properties

appData readonly The folder containing the application data for all users.
appPackage readonly In Mac OS, a Folder object for the folder containing the bundle of the running application.
commonFiles readonly A Folder object for the folder containing common files for all programs installed by the user.
current readonly A Folder object for the current folder.
desktop readonly A Folder object for the folder that contains the user?s desktop.
fs readonly The name of the current file system.
myDocuments readonly A folder pointing to the user’s My Documents folder.
startup readonly A Folder object for the folder containing the executable image of the running application.
system readonly A Folder object for the folder containing the operating system files.
temp readonly A Folder object for the default folder for temporary files.
trash readonly A Folder object for the folder containing deleted items. On Windows, the trash folder is a virtual folder containing a database; therefore, the property value is null on Windows.
userData readonly A Folder object for the folder containing the user’s application data.

Constructors

Folder readonly Creates and returns a new Folder object referring to a given file-system location.

Methods

changePath readonly Changes the path specification of the referenced folder.
create readonly Creates a folder at the location given by this object’s?path?property.
execute readonly Opens this folder in the platform-specific file browser (as if it had been double-clicked in the file browser).
getFiles readonly Retrieves the contents of this folder, filtered by the supplied mask.
getRelativeURI readonly Retrieves and returns the path for this file, relative to the specified base path, in URI notation.
remove readonly Deletes the folder associated with this object from disk immediately, without moving it to the system trash.
rename readonly Renames the associated folder.
resolve readonly Attempts to resolve the file-system alias or shortcut that this object refers to.
selectDlg readonly Opens the built-in platform-specific file-browsing dialog, and creates a new File or Folder object for the selected file or folder.
toSource readonly Creates and returns a serialized string representation of this object.
toString readonly Converts this object to a string.

Static Methods

decode readonly Decodes a UTF-8 encoded string as required by RFC 2396, and returns the decoded string.
encode readonly Encodes a string as required by RFC 2396, and returns the encoded string.
isEncodingAvailable readonly Reports whether a given encoding is available.
selectDialog readonly Opens the built-in platform-specific file-browsing dialog, and creates a new File or Folder object for the selected file or folder.