Hyperlink Konstruktoren

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 und übernimmt ein bestimmtes Inline-Objekt als ursprünglichen Inhalt des neuen Hyperlink.
Hyperlink(Inline, TextPointer)	Initialisiert eine neue Instanz der Hyperlink-Klasse und übernimmt ein bestimmtes Inline-Objekt als ursprünglichen Inhalt des neuen Hyperlink sowie einen TextPointer, mit dem eine Einfügeposition für den neuen Hyperlink angegeben wird.
Hyperlink(TextPointer, TextPointer)	Initialisiert eine neue Instanz der Hyperlink-Klasse mit zwei TextPointer-Objekten, mit denen der Anfang und das Ende des ausgewählten Inhalts angegeben werden, der im neuen Hyperlink enthalten sein soll.

Hyperlink()

Initialisiert eine neue Standardinstanz der Hyperlink-Klasse.

public:
 Hyperlink();

public Hyperlink ();

Public Sub New ()

Hyperlink(Inline)

Initialisiert eine neue Instanz der Hyperlink-Klasse und übernimmt ein bestimmtes Inline-Objekt als ursprünglichen Inhalt des neuen 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)

Parameter

childInline

Inline

Ein Inline-Objekt, mit dem der ursprüngliche Inhalt des neuen Hyperlink angegeben wird.

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)

Hyperlink(Inline, TextPointer)

Initialisiert eine neue Instanz der Hyperlink-Klasse und übernimmt ein bestimmtes Inline-Objekt als ursprünglichen Inhalt des neuen Hyperlink sowie einen TextPointer, mit dem eine Einfügeposition für den neuen Hyperlink angegeben wird.

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, mit dem der ursprüngliche Inhalt des neuen Hyperlink angegeben wird. Dieser Parameter ist möglicherweise null. In diesem Fall wird kein Inline eingefügt.

insertionPosition

TextPointer

Ein TextPointer, der eine Einfügeposition angibt, an der das Hyperlink-Element nach dem Erstellen eingefügt werden soll, oder null, wenn keine automatische Einfügung erfolgen soll.

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)

Hyperlink(TextPointer, TextPointer)

Initialisiert eine neue Instanz der Hyperlink-Klasse mit zwei TextPointer-Objekten, mit denen der Anfang und das Ende des ausgewählten Inhalts angegeben werden, der im neuen Hyperlink enthalten sein soll.

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, mit dem der Anfang des ausgewählten Inhalts angegeben wird, der im neuen Hyperlink enthalten sein soll.

end

TextPointer

Ein TextPointer, mit dem das Ende des ausgewählten Inhalts angegeben wird, der im neuen Hyperlink enthalten sein soll.

Ausnahmen

ArgumentNullException

start oder end ist null.

ArgumentException

start und end werden nicht in einen Inhaltsbereich aufgelöst, der von einem Span-Element umschlossen werden kann. Tritt beispielsweise auf, wenn start und end auf Positionen in verschiedenen Absätzen verweisen.

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 es eine Auswahl vorhandener Inhalte einschließt.