Hyperlink 建構函式

定義

命名空間:

System.Windows.Documents

組件:

PresentationFramework.dll

初始化 Hyperlink 類別的新執行個體。

多載

名稱	Description
Hyperlink()	初始化一個新的預設類別實例 Hyperlink 。
Hyperlink(Inline)	初始化該類別的新實例 Hyperlink ，將指定 Inline 物件作為新 Hyperlink的初始內容。
Hyperlink(Inline, TextPointer)	初始化該類別的新實例 Hyperlink ，取指定 Inline 物件作為新 Hyperlink物件的初始內容，並 TextPointer 指定新物件 Hyperlink的插入位置。
Hyperlink(TextPointer, TextPointer)	初始化該類別的新實例 Hyperlink ，取 TextPointer 兩個物件表示新內容的開始與結束 Hyperlink。

Hyperlink()

初始化一個新的預設類別實例 Hyperlink 。

public:
 Hyperlink();

public Hyperlink();

Public Sub New ()

Hyperlink(Inline)

初始化該類別的新實例 Hyperlink ，將指定 Inline 物件作為新 Hyperlink的初始內容。

public:
 Hyperlink(System::Windows::Documents::Inline ^ childInline);

public Hyperlink(System.Windows.Documents.Inline childInline);

new System.Windows.Documents.Hyperlink : System.Windows.Documents.Inline -> System.Windows.Documents.Hyperlink

Public Sub New (childInline As Inline)

參數

childInline

Inline

一個 Inline 指定新 Hyperlink的初始內容的物件。

範例

以下範例展示了此建構子的使用方法。

// A child Inline element for the new Hyperlink element.
Run runx = new Run("Link text for the Hyperlink element.");

// After this line executes, the new element "hyper1"
// contains the specified Inline element, "runx".
Hyperlink hyperl = new Hyperlink(runx);

' A child Inline element for the new Hyperlink element.
Dim runx As New Run("Link text for the Hyperlink element.")

' After this line executes, the new element "hyper1"
' contains the specified Inline element, "runx".
Dim hyperl As New Hyperlink(runx)

Hyperlink(Inline, TextPointer)

初始化該類別的新實例 Hyperlink ，取指定 Inline 物件作為新 Hyperlink物件的初始內容，並 TextPointer 指定新物件 Hyperlink的插入位置。

public:
 Hyperlink(System::Windows::Documents::Inline ^ childInline, System::Windows::Documents::TextPointer ^ insertionPosition);

public Hyperlink(System.Windows.Documents.Inline childInline, System.Windows.Documents.TextPointer insertionPosition);

new System.Windows.Documents.Hyperlink : System.Windows.Documents.Inline * System.Windows.Documents.TextPointer -> System.Windows.Documents.Hyperlink

Public Sub New (childInline As Inline, insertionPosition As TextPointer)

參數

childInline

Inline

一個 Inline 指定新 Hyperlink的初始內容的物件。 此參數可為 null，此時插入 no Inline 。

insertionPosition

TextPointer

TextPointer A 指定元件建立後插入Hyperlink的位置，或null不自動插入。

範例

以下範例展示了此建構子的使用方法。

// A child Inline element for the new Hyperlink element.
Run runx = new Run("Link text for the Hyperlink element.");

// An empty paragraph will serve as the container for the new Hyperlink element.
Paragraph parx = new Paragraph();

// After this line executes, the new element "hyperl"
// contains the specified Inline element, "runx".  Also, "hyperl" is
// inserted at the point indicated by the insertionPosition parameter,
// which in this case indicates the content start position in the Paragraph
// element "parx".
Hyperlink hyperl = new Hyperlink(runx, parx.ContentStart);

' A child Inline element for the new Hyperlink element.
Dim runx As New Run("Link text for the Hyperlink element.")

' An empty paragraph will serve as the container for the new Hyperlink element.
Dim parx As New Paragraph()

' After this line executes, the new element "hyperl"
' contains the specified Inline element, "runx".  Also, "hyperl" is
' inserted at the point indicated by the insertionPosition parameter, 
' which in this case indicates the content start position in the Paragraph 
' element "parx".
Dim hyperl As New Hyperlink(runx, parx.ContentStart)

Hyperlink(TextPointer, TextPointer)

初始化該類別的新實例 Hyperlink ，取 TextPointer 兩個物件表示新內容的開始與結束 Hyperlink。

public:
 Hyperlink(System::Windows::Documents::TextPointer ^ start, System::Windows::Documents::TextPointer ^ end);

public Hyperlink(System.Windows.Documents.TextPointer start, System.Windows.Documents.TextPointer end);

new System.Windows.Documents.Hyperlink : System.Windows.Documents.TextPointer * System.Windows.Documents.TextPointer -> System.Windows.Documents.Hyperlink

Public Sub New (start As TextPointer, end As TextPointer)

參數

start

TextPointer

A TextPointer 表示將包含於新 Hyperlink.

end

TextPointer

A TextPointer 表示將包含於新 Hyperlink的 。

例外狀況

ArgumentNullException

start 或 end 為 null。

ArgumentException

start 且 end 不結算為適合元素 Span 包圍的內容範圍;例如，若 start 和 end 表示不同段落中的位置。

範例

以下範例展示了此建構子的使用方法。

// Create a paragraph and three text runs to serve as example content.
Paragraph parx = new Paragraph();
Run run1 = new Run("Text run 1.");
Run run2 = new Run("Text to link.");
Run run3 = new Run("Text run 3.");

// Add the three text runs to the paragraph, separated by linebreaks.
parx.Inlines.Add(run1);
parx.Inlines.Add(new LineBreak());
parx.Inlines.Add(run2);
parx.Inlines.Add(new LineBreak());
parx.Inlines.Add(run3);

// After this line executes, the selection of content
// indicated by the "start" and "end" parameters will be
// enclosed by the new Hyperlink.  In this case, the new Hyperlink
// will enclose the entire contents of the text run "run2".
Hyperlink hyperl = new Hyperlink(run2.ContentStart, run2.ContentEnd);

' Create a paragraph and three text runs to serve as example content.  
Dim parx As New Paragraph()
Dim run1 As New Run("Text run 1.")
Dim run2 As New Run("Text to link.")
Dim run3 As New Run("Text run 3.")

' Add the three text runs to the paragraph, separated by linebreaks.
parx.Inlines.Add(run1)
parx.Inlines.Add(New LineBreak())
parx.Inlines.Add(run2)
parx.Inlines.Add(New LineBreak())
parx.Inlines.Add(run3)

' After this line executes, the selection of content
' indicated by the "start" and "end" parameters will be
' enclosed by the new Hyperlink.  In this case, the new Hyperlink
' will enclose the entire contents of the text run "run2".  
Dim hyperl As New Hyperlink(run2.ContentStart, run2.ContentEnd)

備註

此建構器旨在初始化一個新 Hyperlink 元素，使其包含一組既有內容的選取。