Hyperlink Constructeurs

Définition

Espace de noms:

System.Windows.Documents

Assembly:

PresentationFramework.dll

Initialise une nouvelle instance de la classe Hyperlink.

Surcharges

Hyperlink()	Initialise une nouvelle instance par défaut de la classe Hyperlink.
Hyperlink(Inline)	Initialise une nouvelle instance de la classe Hyperlink, en prenant un objet Inline spécifié comme contenu initial du nouveau Hyperlink.
Hyperlink(Inline, TextPointer)	Initialise une nouvelle instance de la classe Hyperlink, en prenant un objet Inline spécifié comme contenu initial du nouvel Hyperlink, et un TextPointer spécifiant une position d’insertion pour le nouveau Hyperlink.
Hyperlink(TextPointer, TextPointer)	Initialise une nouvelle instance de la classe Hyperlink, en prenant deux objets TextPointer qui indiquent le début et la fin d’une sélection de contenu à contenir par la nouvelle Hyperlink.

Hyperlink()

Initialise une nouvelle instance par défaut de la classe Hyperlink.

public:
 Hyperlink();

public Hyperlink ();

Public Sub New ()

Hyperlink(Inline)

Initialise une nouvelle instance de la classe Hyperlink, en prenant un objet Inline spécifié comme contenu initial du nouveau 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)

Paramètres

childInline

Inline

Objet Inline spécifiant le contenu initial du nouvel Hyperlink.

Exemples

L’exemple suivant illustre l’utilisation de ce constructeur.

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

Initialise une nouvelle instance de la classe Hyperlink, en prenant un objet Inline spécifié comme contenu initial du nouvel Hyperlink, et un TextPointer spécifiant une position d’insertion pour le nouveau 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)

Paramètres

childInline

Inline

Objet Inline spécifiant le contenu initial du nouvel Hyperlink. Ce paramètre peut être null, auquel cas aucune Inline n’est insérée.

insertionPosition

TextPointer

Une TextPointer spécifiant une position d’insertion à laquelle insérer l’élément Hyperlink après sa création, ou null pour aucune insertion automatique.

Exemples

L’exemple suivant illustre l’utilisation de ce constructeur.

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

Initialise une nouvelle instance de la classe Hyperlink, en prenant deux objets TextPointer qui indiquent le début et la fin d’une sélection de contenu à contenir par la nouvelle 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)

Paramètres

start

TextPointer

Un TextPointer indiquant le début d’une sélection de contenu à contenir par la nouvelle Hyperlink.

end

TextPointer

Un TextPointer indiquant la fin d’une sélection de contenu à contenir par la nouvelle Hyperlink.

Exceptions

ArgumentNullException

start ou end est null.

ArgumentException

start et end ne sont pas résolus en une plage de contenu adaptée au boîtier par un élément Span ; par exemple, si start et end indiquent des positions dans différents paragraphes.

Exemples

L’exemple suivant illustre l’utilisation de ce constructeur.

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

Remarques

Ce constructeur est destiné à initialiser un nouvel élément Hyperlink afin qu’il place une sélection de contenu préexistant.