LaunchOrNavigateToURL Method
The LaunchOrNavigateToURL method launches the URL or navigates to the Groove URL. Typically, a non-Groove URL is launched in a Web browser or e-mail program.
Syntax
object.LaunchOrNavigateToURL
(
i_URLAs String,
i_IsGrooveURLAs Boolean,
i_NewTransceiverAs Boolean = False
)
Parameters
| Parameter | Description |
|---|---|
i_URL |
A URL, such as an http:// or a mailto: URL, or a Groove URL. Typically, the Groove URL is a URL returned from a lookup. |
i_IsGrooveURL |
Indicates whether it is a Groove URL (TRUE) or a non-Groove URL (FALSE). |
i_NewTransceiver |
Controls whether the Groove URL is opened in a new window (TRUE) or in the same window (FALSE). Optional; default is FALSE. If the user has set the Groove application preference that controls when workspaces are opened in a new window to either Always or Never, this preference controls whether the Groove URL will be opened in a new window and the i_NewTransceiver parameter value will be ignored. |
Remarks
If the i_IsGrooveURL has a FALSE value, Groove displays a modal dialog requesting permission from the user to navigate to the external application. If the user approves, Groove navigates to the specified URL. If the user cancels the operation, Groove will not navigate to the URL. Groove does not display this dialog for Groove URLs.
Note
If the i_IsGrooveURL has a FALSE value, this method displays a modal dialog and should not be called from a script when a transaction is open. Macros are run within an open transaction; consequently, you should not call this method and specify a FALSE value for the i_IsGrooveURL parameter from a macro. See Accessing Forms Records for more information on this restriction. There are no restrictions in calling this method from a macro if the i_IsGrooveURL parameter has a TRUE value.
See Also
Reference
IGrooveFormsToolUIDelegate Interface
NavigateToForm Method
NavigateToView Method