If the optional Parent argument is TRUE, and if Path is a relative path received from another component (usually by a function argument), then the returned path will be modified so that it points at the same file.

For example, if Path is ./image.png, then File.Path("./image.png", True) will return ../image.png, so that the new path points at the same file as the old path from a calling component.

This function is useful when a public API of a component receives a file path from a call located in another component, usually the main project.

Example

' The Response.SendFile() method from the gb.web component
Public Sub SendFile(Path As String, Optional ContentType As String)

  Dim sBuffer As String
  Dim hFile As File

  $bDone = True

  Path = File.RealPath(Path, True)

  If Not Exist(Path) Then
    Print "Status: 404 Not Found"
    Print
    Return
  Endif

  ...

End

You must sure that the path comes from another component before using this feature, and you must call it once.

For example, you can't call Response.SendFile() from the same component (i.e. from gb.web source code) with a local path, because then it will search for that file in the parent component, not in the gb.web component.