Topics
All
Mac OS X
(Only)
Windows
(Only)
Linux
(Only, Not)
iOS
(Only, Not)
Components
Crossplatform Mac & Win
Server
Client
Old
Guides
Examples
New in version:
8.5
9.0
9.1
9.2
9.3
9.4
9.5
10.0
10.1
10.2
Statistic
Component: Files
Functions to work with files and folders.
| Item | Details |
|---|---|
| Files.AccessDate Queries the access date of the file or folder. | All 2.9 |
| Files.AddedToDirectoryDate Queries the date of the file or folder when it was added to parent folder. | Mac only 6.4 |
| Files.AppPath Returns the path to the main executable for this FileMaker solution. | All 2.7 |
| Files.AudioTags Queries audio tags for audio file. | Mac/Win 9.4 |
| Files.CanOpenFile Checks if plugin can read file. | All 5.4 |
| Files.CopyFile Copies files and folders without user interface. | All 2.8 |
| Files.CopyFiles Copies multiple files in parallel. | Mac/iOS 10.0 |
| Files.CreateAlias Creates an alias or link file. | Mac/Win/iOS 8.4 |
| Files.CreateBookmark Creates a bookmark from a file path. | Mac/iOS 3.1 |
| Files.CreateDirectory Creates a directory. | All 2.7 |
| Files.CreateHardLink Creates a new hard link. | All 6.3 |
| Files.CreateSymbolicLink Creates a new symbolic link. | All 6.3 |
| Files.CreationDate Queries the creation date of the file or folder. | All 2.9 |
| Files.Delete Deletes a file directly without moving it to trash. | All 3.3 |
| Files.DeleteFolder Deletes a file or folder directly without moving to trash. | All 4.2 |
| Files.DirectoryExists Checks whether a directory exists with the given path. | All 2.7 |
| Files.DiskInfo Queries information about a volume. | All 5.0 |
| Files.FileDisplayName Queries the display name of the file or folder. | All 2.9 |
| Files.FileExists Checks whether a file exists with the given path. | All 2.7 |
| Files.FileExtension Queries the file extension of the given path. | All 5.2 |
| Files.FileInfo Queries some file information. | Mac/Win/iOS 4.3 |
| Files.FileKind Queries the file kind string. | Mac/Win 2.9 |
| Files.FileName Queries the file name of the given path. | All 2.9 |
| Files.FileSize Queries file size. | All 2.7 |
| Files.FileUTITypes Queries uniform type identifiers for this file. | Mac only 2.9 |
| Files.FolderSize Calculate sizes of folder. | All 6.2 |
| Files.GetComment Queries Finder's file comment. | Mac only 6.2 |
| Files.GetFinderLabel Queries the label of the file or folder. | Mac only 6.2 |
| Files.GetNodeID Queries the NodeID fo the file or folder. | Mac/Win 3.1 |
| Files.GetPathFromNodeID Finds the file or folder for the given NodeID on the given volume. | Mac/Win 3.1 |
| Files.GetPosixPermissions Queries posix file permissions. | Mac/Linux/iOS 4.3 |
| Files.GetTagNames Queries names of the tags assigned to the file/folder. | Mac only 3.5 |
| Files.IsHidden Queries hidden state of a file or folder. | Mac/Win 7.1 |
| Files.ItemExists Checks whether a item exists with the given path. | All 2.7 |
| Files.Launch Launches the file. | Mac/Win 2.7 |
| Files.LaunchFile Launches the file. | Mac/Win 2.7 |
| Files.List Queries list of file names in folder. | All 2.8 |
| Files.ListRecursive Queries list of paths in folder. | All 4.1 |
| Files.ListVolumes Lists mounted volumes. | Mac/Win 6.5 |
| Files.ModificationDate Queries the modification date of the file or folder. | All 2.9 |
| Files.Mount Mounts a network share. | Mac/Win/Linux 5.1 |
| Files.MountPath Queries mount path for a volume. | Mac/Win 8.3 |
| Files.MoveFile Moves a file or folder without user interface. | All 2.8 |
| Files.MoveToTrash Deletes an item by moving it to trash without user interface. | All 2.8 |
| Files.ReadFile Reads a file with the given path. | All 3.5 |
| Files.ReadJPEG Reads a JPEG file from the file system. | All 4.3 |
| Files.ReadPDF Reads a PDF file from the file system. | All 4.3 |
| Files.ReadPNG Reads a PNG file from the file system. | All 4.3 |
| Files.RenameFile Renames a file or folder without user interface. | All 2.8 |
| Files.ResolveAlias Resolves an alias file. | Mac/Win/iOS 8.4 |
| Files.ResolveBookmark Resolves a bookmark. | Mac/iOS 3.1 |
| Files.RevealFile Reveals the file/folder in the shell. | Mac/Win 2.7 |
| Files.SetAudioTags Sets audio tags for audio file. | Mac/Win/Linux 9.4 |
| Files.SetComment Sets the file comment. | Mac only 6.2 |
| Files.SetCreationDate Sets the file creation date. | Mac/Win/iOS 7.2 |
| Files.SetFinderLabel Sets the Finder label. | Mac only 6.2 |
| Files.SetHidden Sets the hidden state of a file or folder. | Mac/Win 7.1 |
| Files.SetModificationDate Sets the file modification date. | All 7.2 |
| Files.SetPosixPermissions Sets posix file permissions. | Mac/Linux/iOS 4.3 |
| Files.SetTagNames Sets the tags for a file/folder. | Mac only 3.5 |
| Files.Unmount Unmount a volume. | Mac/Win/Linux 5.1 |
| Files.WriteFile Writes a file with the given data. | All 3.5 |
| Icon.ClearIcon Clears the custom icon for the file or directory at the specified path. | Mac only 2.7 |
| Icon.GetIcon Queries the Finder icon for the file or folder with the given path. | Mac/Win 2.3 |
| Icon.GetIconWithQuickLook Queries the Finder icon for the file or folder with the given path. | Mac/Win 2.3 |
| Icon.SetIcon Sets the icon for the file or directory at the specified path. | Mac only 2.7 |
| MountNotification.Install Installs a script trigger to be called when a disk mounts/unmounts. | Mac/Win 5.0 |
| MountNotification.Uninstall Uninstalls notification for mount script trigger. | Mac/Win 5.0 |
68 functions.
Release notes
- Version 10.0
- Added Files.CopyFiles function.
- Fixed an issue for Files.MoveFile and Files.CopyFile where unability to move an old file to trash caused a problem on AFP volumes.
- Fixed crashes with Files.CopyFiles function with invalid paths.
- Version 9.4
- Added Files.AudioTags to read ID tags from audio files.
- Added Files.SetAudioTags to change ID tags for audio files, e.g. ID3v2 tags in MP3 files.
- Fixed Files.FileSize for iOS.
- Version 9.2
- Added check to Files.Delete to prevent you using paths ending in // or \\, which may unexpectedly delete a whole folder.
- Added new parameter for Files.CreateAlias to specify icon for the alias/link file.
- Version 9.0
- Added MinimalBookmark parameter to Files.CreateBookmark function.
- Version 8.5
- Changed Files.FileName to work on Windows/Linux if last character in path is (back)slash.
- Implemented Files.GetNodeID and Files.GetPathFromNodeID for Windows.
- Improved error handling for Files.CopyFile and Files.MoveFile.
- Rewrote Files.CopyFile and Files.MoveFile for Mac/iOS to better overwrite files.
- Version 8.4
- Added Files.CreateAlias and Files.ResolveAlias functions.
- Changed Files.ListRecursive to use either / or \ for path delimiter on Windows.
- Upgraded Files.GetPathFromNodeID and Files.GetNodeID to use newer APIs which work for AFS volumes.
- Version 8.3
- Added Files.MountPath function.
- Version 8.2
- Fixed a rare problem on Mac with Files.RenameFile.
- Rewrote Files.RenameFile for Mac.
- Version 8.1
- Improved Files.Launch to better handle passing flag as text.
- Version 7.5
- Added selector CopyRight for Files.FileInfo to query copyright string on Mac.
- Version 7.4
- Changed Files.RenameFile to accept only file name as second parameter instead of file path for Windows. That was inconsistent to the Mac behavior where the name was enough.
- Version 7.3
- Added new flag for Files.ListRecursive to ignore invisible folders and better check for hidden elements.
- Added new option DriveType for Files.DiskInfo on Windows.
- Version 7.2
- Added Files.SetCreationDate.
- Added Files.SetModificationDate.
- Added NewInstance parameter for Files.LaunchFile and Files.Launch function.
- Version 7.1
- Added Files.IsHidden and Files.SetHidden.
- Improved error handling for Files.ListRecursive.
- Version 7.0
- Added progress window option to Files.CopyFile and Files.MoveFile for Windows.
Feedback: Report problem or ask question.
Links
MBS Xojo blog
