Hyperlinks.Add 方法 (Publisher)

將新的 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 支援與意見反應。