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


Returns a FolderItem based on the string passed to it.


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


All project types on all supported operating systems.