Hyperlink Construtores

Definição

Espaço de Nomes:: System.Windows.Documents

Assemblagem:: PresentationFramework.dll

Importante

Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.

Inicializa uma nova instância da Hyperlink classe.

Sobrecargas

Name	Description
Hyperlink()	Inicializa uma nova instância padrão da Hyperlink classe.
Hyperlink(Inline)	Inicializa uma nova instância da Hyperlink classe, tomando um objeto especificado Inline como conteúdo inicial do novo Hyperlink.
Hyperlink(Inline, TextPointer)	Inicializa uma nova instância da Hyperlink classe, tomando um objeto especificado Inline como conteúdo inicial do novo Hyperlink, e TextPointer especificando uma posição de inserção para o novo Hyperlink.
Hyperlink(TextPointer, TextPointer)	Inicializa uma nova instância da Hyperlink classe, tomando dois TextPointer objetos que indicam o início e o fim de uma seleção de conteúdo a ser contida pelo novo Hyperlink.

Hyperlink()

Inicializa uma nova instância padrão da Hyperlink classe.

public:
 Hyperlink();

public Hyperlink();

Public Sub New ()

Aplica-se a

Hyperlink(Inline)

Inicializa uma nova instância da Hyperlink classe, tomando um objeto especificado Inline como conteúdo inicial do novo 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

Um Inline objeto que especifica o conteúdo inicial do novo Hyperlink.

Exemplos

O exemplo seguinte demonstra a utilização deste construtor.

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

Aplica-se a

Hyperlink(Inline, TextPointer)

Inicializa uma nova instância da Hyperlink classe, tomando um objeto especificado Inline como conteúdo inicial do novo Hyperlink, e TextPointer especificando uma posição de inserção para o novo 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

Um Inline objeto que especifica o conteúdo inicial do novo Hyperlink. Este parâmetro pode ser null, caso em que não Inline é inserido.

insertionPosition: TextPointer

Uma TextPointer especificação de uma posição de inserção para inserir o Hyperlink elemento após a sua criação, ou null para não haver inserção automática.

Exemplos

O exemplo seguinte demonstra a utilização deste construtor.

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

Aplica-se a

Hyperlink(TextPointer, TextPointer)

Inicializa uma nova instância da Hyperlink classe, tomando dois TextPointer objetos que indicam o início e o fim de uma seleção de conteúdo a ser contida pelo novo 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

A indicando TextPointer o início de uma seleção de conteúdo a ser contido pelo novo Hyperlink.

end: TextPointer

A indicando TextPointer o fim de uma seleção de conteúdo a ser contido pelo novo Hyperlink.

Exceções

ArgumentNullException

start ou end é null.

ArgumentException

start e end não resolvem para um intervalo de conteúdo adequado para encerramento por um Span elemento; por exemplo, se start e end indicam posições em parágrafos diferentes.

Exemplos

O exemplo seguinte demonstra a utilização deste construtor.

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

Observações

Este construtor destina-se a inicializar um novo Hyperlink elemento de modo a que contenha uma seleção de conteúdo pré-existente.

Aplica-se a

Comentários

Esta página foi útil?