GetTrueFolderItem

Method

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

Syntax

result=GetTrueFolderItem(path[,pathMode])

Part	Type	Description
result	FolderItem	FolderItem that refers to the item referenced by path.
path	String	Pathname to the file or folder.
pathMode Introduced 5.5	Class Constant	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:///".

Notes

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

Examples

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")
TextField1.Text = f.Name // the alias to the app
TextField2.Text = g.Name // the application