Hyperlink 建構函式
定義
重要
部分資訊涉及發行前產品,在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊,不做任何明確或隱含的瑕疵擔保。
初始化 Hyperlink 類別的新執行個體。
多載
Hyperlink() |
初始化 Hyperlink 類別的新預設執行個體。 |
Hyperlink(Inline) | |
Hyperlink(Inline, TextPointer) |
初始化 Hyperlink 類別的新執行個體,並將指定的 Inline 物件做為新 Hyperlink 的初始內容,以及會替新 TextPointer 指定插入位置的 Hyperlink。 |
Hyperlink(TextPointer, TextPointer) |
初始化 Hyperlink 類別的新執行個體,並採用兩個 TextPointer 物件,該物件表示新 Hyperlink 要包含之內容選取範圍的開頭及結尾。 |
Hyperlink()
Hyperlink(Inline)
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)
參數
範例
下列範例示範此建構函式的使用方式。
// 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)
參數
- 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 要包含之內容選取範圍的結尾。
例外狀況
start
或 end
為 null
。
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 元素,使其括住預先存在的內容選取範圍。