將新的 Hyperlink 物件新增至指定的 Hyperlink 集合,並傳回新的 Hyperlink 物件。
語法
運算式。新增 (text、 address、 RelativePage、 PageID、 TextToDisplay)
expression 代表 Hyperlinks 物件的變數。
參數
| 名稱 | 必要/選用 | 資料類型 | 描述 |
|---|---|---|---|
| 文字 | 必要 | TextRange | TextRange 物件。 以指定須轉換成超連結文字範圍。 |
| Address | 選用 | String | 新超連結位址。 如果 RelativePage 是 pbHlinkTargetTypeURL (預設) 或 pbHlinkTargetTypeEmail,則必須指定 地址 ,否則會發生錯誤。 |
| RelativePage | 選用 | PbHlinkTargetType | 要新增的超連結類型。 可以是其中一個 PbHlinkTargetType 常數;預設值為 pbHlinkTargetTypeURL。 |
| PageID | 選用 | Long | 新超連結的目的地頁面] 頁面上識別碼。 如果 RelativePage 為 pbHlinkTargetTypePageID,則必須指定 PageID ,否則會發生錯誤。 頁面識別碼對應至 [目的地] 頁面上的 PageID 屬性。 |
| TextToDisplay | 選用 | String | 新超連結顯示文字。 如果指定 TextToDisplay 會取代 文字 引數所指定的文字範圍。 |
傳回值
超連結
範例
下列範例將超連結新增至使用中出版物第一頁的圖案一和圖案二。 第一個超連結指向外部網站,第二個連結指向出版物的第四頁。 圖形 1 和圖形 2 必須是文字方塊,出版物中必須至少有四頁,此範例才能運作。
Dim hypNew As Hyperlink
Dim lngPageID As Long
Dim strPage As String
With ActiveDocument.Pages(1).Shapes(1).TextFrame
Set hypNew = .TextRange.Hyperlinks.Add(Text:=.TextRange, _
Address:="https://www.tailspintoys.com/", _
TextToDisplay:="Tailspin")
End With
lngPageID = ActiveDocument.Pages(4).PageID
strPage = "Go to page " _
& Str(ActiveDocument.Pages(4).PageNumber)
With ActiveDocument.Pages(1).Shapes(2).TextFrame
Set hypNew = .TextRange.Hyperlinks.Add(Text:=.TextRange, _
RelativePage:=pbHlinkTargetTypePageID, _
PageID:=lngPageID, _
TextToDisplay:=strPage)
End With
支援和意見反應
有關於 Office VBA 或這份文件的問題或意見反應嗎? 如需取得支援服務並提供意見反應的相關指導,請參閱 Office VBA 支援與意見反應。