Method

FolderItem.GetRelative

---

Warning

This item was deprecated in version 2019r2. Please use FolderItem.FromSaveInfo as a replacement.

Description

Returns a FolderItem based on the string passed to it.

Notes

If the string indicates a relative path, the current FolderItem is considered its reference point. If the string passed to it is absolute, then the current FolderItem is ignored when resolving the path.

GetRelative returns Nil only if there is not sufficient information in SaveInfo to construct a FolderItem (e.g., using a relative path that causes the parsing to descend below root level).

Sample code

Dim path As String
Dim f, g As FolderItem
f = New FolderItem
g = f.GetRelative(f.GetSaveInfo(Volume(0).Child("Documents"), 0))
If g <> Nil Then
  path = g.NativePath
End If

Compatibility

All project types on all supported operating systems.