Hyperlink 构造函数

定义

命名空间:

System.Windows.Documents

程序集:

PresentationFramework.dll

初始化 Hyperlink 类的新实例。

重载

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，在这种情况下，不插入任何 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 或 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 元素，使其包含所选的预先存在内容。