Hyperlink Costruttori

Definizione

Spazio dei nomi:

System.Windows.Documents

Assembly:

PresentationFramework.dll

Inizializza una nuova istanza della classe Hyperlink.

Overload

Hyperlink()	Inizializza una nuova istanza predefinita della classe Hyperlink.
Hyperlink(Inline)	Inizializza una nuova istanza della classe Hyperlink, accettando un oggetto Inline specificato come contenuto iniziale del nuovo oggetto Hyperlink.
Hyperlink(Inline, TextPointer)	Inizializza una nuova istanza della classe Hyperlink, accettando un oggetto Inline specificato come contenuto iniziale del nuovo oggetto Hyperlink e un oggetto TextPointer che specifica una posizione di inserimento per il nuovo elemento Hyperlink.
Hyperlink(TextPointer, TextPointer)	Inizializza una nuova istanza della classe Hyperlink, accettando due oggetti TextPointer che indicano l'inizio e la fine di una selezione di contenuto che il nuovo oggetto Hyperlink conterrà.

Hyperlink()

Inizializza una nuova istanza predefinita della classe Hyperlink.

public:
 Hyperlink();

public Hyperlink ();

Public Sub New ()

Hyperlink(Inline)

Inizializza una nuova istanza della classe Hyperlink, accettando un oggetto Inline specificato come contenuto iniziale del nuovo oggetto 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)

Parametri

childInline

Inline

Oggetto Inline che specifica il contenuto iniziale del nuovo oggetto Hyperlink.

Esempio

Nell'esempio seguente viene illustrato l'utilizzo di questo costruttore.

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

Inizializza una nuova istanza della classe Hyperlink, accettando un oggetto Inline specificato come contenuto iniziale del nuovo oggetto Hyperlink e un oggetto TextPointer che specifica una posizione di inserimento per il nuovo elemento 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)

Parametri

childInline

Inline

Oggetto Inline che specifica il contenuto iniziale del nuovo oggetto Hyperlink. Questo parametro può essere null, nel qual caso non viene inserito alcun oggetto Inline.

insertionPosition

TextPointer

Oggetto TextPointer che specifica la posizione di inserimento nella quale inserire l'oggetto Hyperlink dopo averlo creato oppure null per fare in modo che non avvenga alcun inserimento automatico.

Esempio

Nell'esempio seguente viene illustrato l'utilizzo di questo costruttore.

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

Inizializza una nuova istanza della classe Hyperlink, accettando due oggetti TextPointer che indicano l'inizio e la fine di una selezione di contenuto che il nuovo oggetto Hyperlink conterrà.

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)

Parametri

start

TextPointer

Un TextPointer che indica l'inizio di una selezione di contenuto che il nuovo Hyperlink conterrà.

end

TextPointer

Un TextPointer che indica la fine di una selezione di contenuto che il nuovo Hyperlink conterrà.

Eccezioni

ArgumentNullException

start o end è null.

ArgumentException

start e end non vengono risolti in un intervallo di contenuto adatto a essere incluso in un elemento Span, ad esempio se start e end indicano posizioni in paragrafi diversi.

Esempio

Nell'esempio seguente viene illustrato l'utilizzo di questo costruttore.

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

Commenti

Questo costruttore deve inizializzare un nuovo Hyperlink elemento in modo che contenga una selezione di contenuto preesistente.