Hyperlink Constructores

Definición

Espacio de nombres:

System.Windows.Documents

Ensamblado:

PresentationFramework.dll

Inicializa una nueva instancia de la clase Hyperlink.

Sobrecargas

Hyperlink()	Inicializa una nueva instancia predeterminada de la clase Hyperlink.
Hyperlink(Inline)	Inicializa una nueva instancia de la clase Hyperlink, tomando un objeto Inline especificado como el contenido inicial del nuevo Hyperlink.
Hyperlink(Inline, TextPointer)	Inicializa una nueva instancia de la clase Hyperlink, tomando un objeto de Inline especificado como el contenido inicial del nuevo Hyperlinky un TextPointer especificando una posición de inserción para el nuevo Hyperlink.
Hyperlink(TextPointer, TextPointer)	Inicializa una nueva instancia de la clase Hyperlink, tomando dos objetos TextPointer que indican el principio y el final de una selección de contenido que debe contener el nuevo Hyperlink.

Hyperlink()

Inicializa una nueva instancia predeterminada de la clase Hyperlink.

public:
 Hyperlink();

public Hyperlink ();

Public Sub New ()

Hyperlink(Inline)

Inicializa una nueva instancia de la clase Hyperlink, tomando un objeto Inline especificado como el contenido inicial del nuevo 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)

Parámetros

childInline

Inline

Objeto Inline que especifica el contenido inicial del nuevo Hyperlink.

Ejemplos

En el ejemplo siguiente se muestra el uso de este constructor.

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

Inicializa una nueva instancia de la clase Hyperlink, tomando un objeto de Inline especificado como el contenido inicial del nuevo Hyperlinky un TextPointer especificando una posición de inserción para el nuevo 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)

Parámetros

childInline

Inline

Objeto Inline que especifica el contenido inicial del nuevo Hyperlink. Este parámetro puede ser null, en cuyo caso no se inserta ningún Inline.

insertionPosition

TextPointer

Un TextPointer especificando una posición de inserción en la que se va a insertar el elemento Hyperlink después de crearlo o null para que no se inserte automáticamente.

Ejemplos

En el ejemplo siguiente se muestra el uso de este constructor.

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

Inicializa una nueva instancia de la clase Hyperlink, tomando dos objetos TextPointer que indican el principio y el final de una selección de contenido que debe contener el nuevo 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)

Parámetros

start

TextPointer

Un TextPointer que indica el principio de una selección de contenido que debe contener el nuevo Hyperlink.

end

TextPointer

Un TextPointer que indica el final de una selección de contenido que debe contener el nuevo Hyperlink.

Excepciones

ArgumentNullException

start o end es null.

ArgumentException

start y end no se resuelven en un rango de contenido adecuado para el contenedor mediante un elemento Span; por ejemplo, si start y end indican posiciones en párrafos diferentes.

Ejemplos

En el ejemplo siguiente se muestra el uso de este constructor.

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

Comentarios

Este constructor está pensado para inicializar un nuevo elemento Hyperlink de modo que incluya una selección de contenido preexistente.