Syntax

Locations.GotoLocationInApplication( applicationPath, options = 0)

Purpose

Sends the Locations collection to the user interface the applicationPath parameter specifies. If the user interface supports the Locations.GotoLocation method, the user interface displays the location by updating which controls are visible and active and by updating the selected state of controls.

Remarks

If the applicationPath parameter specifies the path of the currently executing user interface, this method behaves the same as the Locations.GotoLocation method. Otherwise, this method differs from the Locations.GotoLocation method in the following ways:

• This method supports only Locations of LocationKind_File type.
• If the applicationPath parameter specifies the path of a user interface that is currently executing, this method attempts to go to the location in that instance of the user interface. Otherwise, this method starts a new instance of the user interface and attempts to go to the location in that instance.
• This method does not set the Locations.LocationFound property and does not use the Locations.LocationNotFoundMessage property when the applicationPath parameter specifies an external user interface.

Parameters

applicationPath As String

[In] Specifies the absolute path of the user interface application.

options As Long

[In] Specifies any combination of GotoLocationOptions . This method does not use the GotoLocationOption_DoNotDisplayMessageIfLocationNotFound option unless the applicationPath parameter specifies the path of the currently executing user interface.

This parameter has a default value of 0 .

See Also

GotoLocationOptions

LocationKinds

Locations

Locations.GotoLocation

Locations.LocationFound

Locations.LocationNotFoundMessage