Hyperlink Konstruktoren

  • Referenz

Definition

Namespace:
System.Windows.Documents
Assembly:
PresentationFramework.dll

Initialisiert eine neue Instanz der Hyperlink Klasse.

Überlädt

Hyperlink()

Initialisiert eine neue Standardinstanz der Hyperlink Klasse.
Hyperlink(Inline)

Initialisiert eine neue Instanz der Hyperlink Klasse, wobei ein angegebenes Inline -Objekt als anfänglicher Inhalt des neuen Hyperlinkverwendet wird.
Hyperlink(Inline, TextPointer)

Initialisiert eine neue Instanz der Hyperlink Klasse, wobei ein angegebenes Inline -Objekt als anfänglicher Inhalt der neuen Hyperlinkverwendet wird, und ein TextPointer die Einfügeposition für die neue Hyperlinkangibt.
Hyperlink(TextPointer, TextPointer)

Initialisiert eine neue Instanz der Hyperlink-Klasse, wobei zwei TextPointer Objekte verwendet werden, die den Anfang und das Ende einer Auswahl von Inhalten angeben, die in der neuen Hyperlinkenthalten sein sollen.

Initialisiert eine neue Standardinstanz der Hyperlink Klasse.

public:
 Hyperlink();
public Hyperlink ();
Public Sub New ()

Gilt für:

Initialisiert eine neue Instanz der Hyperlink Klasse, wobei ein angegebenes Inline -Objekt als anfänglicher Inhalt des neuen Hyperlinkverwendet wird.

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)

Parameter

childInline
Inline

Ein Inline Objekt, das den anfänglichen Inhalt des neuen Hyperlinkangibt.

Beispiele

Im folgenden Beispiel wird die Verwendung dieses Konstruktors veranschaulicht.

// 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)

Gilt für:

Initialisiert eine neue Instanz der Hyperlink Klasse, wobei ein angegebenes Inline -Objekt als anfänglicher Inhalt der neuen Hyperlinkverwendet wird, und ein TextPointer die Einfügeposition für die neue Hyperlinkangibt.

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)

Parameter

childInline
Inline

Ein Inline Objekt, das den anfänglichen Inhalt des neuen Hyperlinkangibt. Dieser Parameter kann nullsein, in diesem Fall wird keine Inline eingefügt.

insertionPosition
TextPointer

Ein TextPointer eine Einfügeposition angeben, an der das Hyperlink Element nach der Erstellung eingefügt werden soll, oder null, ohne dass das automatische Einfügen erfolgt.

Beispiele

Im folgenden Beispiel wird die Verwendung dieses Konstruktors veranschaulicht.

// 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)

Gilt für:

Initialisiert eine neue Instanz der Hyperlink-Klasse, wobei zwei TextPointer Objekte verwendet werden, die den Anfang und das Ende einer Auswahl von Inhalten angeben, die in der neuen Hyperlinkenthalten sein sollen.

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)

Parameter

start
TextPointer

Ein TextPointer, der den Anfang einer Auswahl von Inhalten angibt, die in der neuen Hyperlinkenthalten sein sollen.

end
TextPointer

Ein TextPointer, der das Ende einer Auswahl von Inhalten angibt, die in der neuen Hyperlinkenthalten sein sollen.

Ausnahmen

ArgumentNullException

start oder end ist null.

ArgumentException

start und end werden nicht in einen Für die Anlage geeigneten Inhaltsbereich durch ein Span-Element aufgelöst; Wenn z. B. start und end Positionen in verschiedenen Absätzen angeben.

Beispiele

Im folgenden Beispiel wird die Verwendung dieses Konstruktors veranschaulicht.

// 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)

Hinweise

Dieser Konstruktor soll ein neues Hyperlink-Element initialisieren, sodass er eine Auswahl vorhandener Inhalte einschließt.

Gilt für: