Hyperlink 建構函式

定義

命名空間:

System.Windows.Documents

組件:

PresentationFramework.dll

初始化 Hyperlink 類別的新實例。

多載

Hyperlink()	初始化 Hyperlink 類別的新預設實例。
Hyperlink(Inline)	初始化 Hyperlink 類別的新實例，以指定的 Inline 對象作為新 Hyperlink的初始內容。
Hyperlink(Inline, TextPointer)	初始化 Hyperlink 類別的新實例，以指定的 Inline 對象作為新 Hyperlink的初始內容，以及指定新 Hyperlink插入位置的 TextPointer。
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的初始內容，以及指定新 Hyperlink插入位置的 TextPointer。

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，在此情況下不會插入任何 Inline。

insertionPosition

TextPointer

TextPointer 指定要在建立項目之後插入 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

TextPointer，指出新 Hyperlink所要包含之內容的選取範圍開頭。

end

TextPointer

TextPointer，指出新 Hyperlink所要包含之內容的選取範圍結尾。

例外狀況

ArgumentNullException

start 或 endnull。

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 專案，使其包含預先存在內容的選取範圍。