GetTrueFolderItem Function

Returns a FolderItem that refers the true path (without resolving any aliases) of a file or folder.

Syntax
result = GetTrueFolderItem( path, [pathMode] )

Parameters
path | String | Pathname to the file or folder.
pathMode | Class (Optional) | FolderItem class constant, PathTypeAbsolute, PathTypeURL, or PathTypeShell, indicating whether the path is a Shell path, an "ordinary" path, or a path in the form of a URL. If you pass a shell path, it must be an absolute path. If not, an UnsupportedFormatException will result. See the ShellPath property of the FolderItem class for information about shell paths. If you pass the PathTypeURL constant, the URL must begin with "file:///".

Return Value
Result | FolderItem | FolderItem that refers to the item referenced by path.

# Note

If the item referenced by path does not exist, GetTrueFolderItem returns Nil.

# Example

The following example compares GetTrueFolderItem with GetFolderItem. While both functions are passed the same absolute path to an alias, f refers to the alias, while g refers to the actual application.

Dim f, g as FolderItem
f=GetTrueFolderItem("Hard Disk:Photoshop")
g= GetFolderItem("Hard Disk:Photoshop")
EditField1.text=f.Name //the alias to the app
EditField2.text=g.Name //the application

# See Also

GetFolderItem function; FolderItem class.