GetTrueFolderItem

From Xojo Documentation
Jump to: navigation, search
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


See Also

GetFolderItem function; FolderItem class.

Personal tools
Namespaces

Variants
Actions
Main
Content
Starting Out
Dig Deeper
More Help
Toolbox
About