Application.FollowHyperlink Method (Access)
The FollowHyperlink method opens the document or Web page specified by a hyperlink address.
Syntax
expression .FollowHyperlink(Address, SubAddress, NewWindow, AddHistory, ExtraInfo, Method, HeaderInfo)
expression A variable that represents an Application object.
Parameters
Name |
Required/Optional |
Data Type |
Description |
|---|---|---|---|
Address |
Required |
String |
A string expression that evaluates to a valid hyperlink address. |
SubAddress |
Optional |
String |
A string expression that evaluates to a named location in the document specified by the address argument. The default is a zero-length string (" "). |
NewWindow |
Optional |
Boolean |
A Boolean value where True (–1) opens the document in a new window and False (0) opens the document in the current window. The default is False. |
AddHistory |
Optional |
Boolean |
A Boolean value where True adds the hyperlink to the History folder and False doesn't add the hyperlink to the History folder. The default is True. |
ExtraInfo |
Optional |
Variant |
A string or an array of Byte data that specifies additional information for navigating to a hyperlink. For example, this argument may be used to specify a search parameter for an .asp or .idc file. In your Web browser, the extrainfo argument may appear after the hyperlink address, separated from the address by a question mark (?). You don't need to include the question mark when you specify the extrainfo argument. |
Method |
Optional |
MsoExtraInfoMethod |
A MsoExtraInfoMethod constant that specifies how the extrainfo argument is attached. |
HeaderInfo |
Optional |
String |
A string that specifies header information. By default the headerinfo argument is a zero-length string. |
Remarks
By using the FollowHyperlink method, you can follow a hyperlink that doesn't exist in a control. This hyperlink may be supplied by you or by the user. For example, you can prompt a user to enter a hyperlink address in a dialog box, then use the FollowHyperlink method to follow that hyperlink.
You can use the extrainfo and method arguments to supply additional information when navigating to a hyperlink. For example, you can supply parameters to a search engine.
You can use the Follow method to follow a hyperlink associated with a control.
Example
The following function prompts a user for a hyperlink address and then follows the hyperlink:
Function GetUserAddress() As Boolean
Dim strInput As String
On Error GoTo Error_GetUserAddress
strInput = InputBox("Enter a valid address")
Application.FollowHyperlink strInput, , True
GetUserAddress = True
Exit_GetUserAddress:
Exit Function
Error_GetUserAddress:
MsgBox Err & ": " & Err.Description
GetUserAddress = False
Resume Exit_GetUserAddress
End Function
You could call this function with a procedure such as the following:
Sub CallGetUserAddress()
If GetUserAddress = True Then
MsgBox "Successfully followed hyperlink."
Else
MsgBox "Could not follow hyperlink."
End If
End Sub