Hyperlink Classe

Definizione

public ref class Hyperlink sealed : Span

/// [Windows.Foundation.Metadata.Activatable(65536, Windows.Foundation.UniversalApiContract)]
/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
class Hyperlink final : Span

/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
/// [Windows.Foundation.Metadata.Activatable(65536, "Windows.Foundation.UniversalApiContract")]
class Hyperlink final : Span

[Windows.Foundation.Metadata.Activatable(65536, typeof(Windows.Foundation.UniversalApiContract))]
[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
public sealed class Hyperlink : Span

[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
[Windows.Foundation.Metadata.Activatable(65536, "Windows.Foundation.UniversalApiContract")]
public sealed class Hyperlink : Span

Public NotInheritable Class Hyperlink
Inherits Span

<Hyperlink .../>

Ereditarietà

Object Platform::Object IInspectable DependencyObject TextElement Inline Span Hyperlink

Attributi

ActivatableAttribute ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Requisiti Windows

Esempio

Ecco un esempio di un semplice elemento Hyperlink in un controllo TextBlock.

In XAML la creazione di elementi di contenuto è implicita, quindi puoi aggiungere il testo del collegamento direttamente al collegamento Hyperlink e il collegamento ipertestuale direttamente all'elemento TextBlock .

Nel codice è necessario creare in modo esplicito ogni elemento Run , impostarne la proprietà Text e aggiungerla all'insieme Inlines appropriato ,ovvero Hyperlink o TextBlock.

<TextBlock><Hyperlink NavigateUri="http://www.bing.com">Go to Bing</Hyperlink></TextBlock>

// Create a TextBlock. The hyperlink is the TextBlock content. 
TextBlock tb = new TextBlock();

// Create a Hyperlink and a Run. 
// The Run provides the visible content of the hyperlink. 
Hyperlink hyperlink = new Hyperlink();
Run run = new Run();

// Set the Text property on the Run. This will be the visible text of the hyperlink.
run.Text = "Go to Bing";
// Set the URI for the Hyperlink. 
hyperlink.NavigateUri = new Uri("http://www.bing.com");

// Add the Run to Hyperlink.Inlines collection.
hyperlink.Inlines.Add(run);
// Add the text elements to the TextBlock.Inlines collection.
tb.Inlines.Add(hyperlink);
// Add the TextBlock to a StackPanel (defined in the XAML page).        
stackPanel.Children.Add(tb);

In questo esempio viene illustrato un elemento Hyperlink in un controllo TextBlock con altro testo.

In XAML la creazione di elementi di contenuto è implicita, quindi puoi aggiungere il testo del collegamento direttamente al collegamento ipertestuale. L'elemento Span con l'attributo xml:space="preserve" viene usato per mantenere lo spazio vuoto intorno al collegamento ipertestuale.

Nel codice è necessario creare in modo esplicito ogni elemento Run , impostarne la proprietà Text e aggiungerla all'insieme Inlines appropriato ,ovvero Hyperlink o TextBlock.

<TextBlock>
    <Span xml:space="preserve"><Run>Open </Run><Hyperlink NavigateUri="http://www.bing.com">Bing</Hyperlink><Run> in your browser.</Run></Span>
</TextBlock>

// Create a TextBlock. The hyperlink is part of the TextBlock content. 
// Set TextWrapping so that the text and the hyperlink wrap if the content is too wide.
TextBlock tb = new TextBlock();
tb.TextWrapping = TextWrapping.Wrap;

// Create a Hyperlink and a Run. 
// The Run provides the visible content of the hyperlink. 
Hyperlink hyperlink = new Hyperlink();
Run run = new Run();
// Set the Text property on the Run. This will be the visible text of the hyperlink.
run.Text = "Bing";
// Set the URI for the Hyperlink. 
hyperlink.NavigateUri = new Uri("http://www.bing.com");
//Add the Run to Hyperlink.Inlines collection.
hyperlink.Inlines.Add(run);

// Create Run elements for the text around the hyperlink.
Run run1 = new Run();
Run run2 = new Run();            
//Set the Text property on the Run elements.
run1.Text = "Open ";
run2.Text = " in your browser.";

// Add the text elements to the TextBlock.Inlines collection.
tb.Inlines.Add(run1);
tb.Inlines.Add(hyperlink);
tb.Inlines.Add(run2);

// Add the TextBlock to a StackPanel (defined in the XAML page).        
stackPanel.Children.Add(tb);

Ecco un esempio di un semplice elemento Hyperlink in un controllo TextBlock.

In XAML la creazione di elementi di contenuto è implicita, quindi puoi aggiungere il testo del collegamento direttamente al collegamento Hyperlink e il collegamento ipertestuale direttamente all'elemento TextBlock . L'elemento Span con l'attributo xml:space="preserve" viene usato per mantenere lo spazio vuoto intorno al collegamento ipertestuale.

Nel codice è necessario creare in modo esplicito ogni elemento di testo ,ad esempio Run, Paragraph o Italic, e aggiungerlo all'insieme Inlines appropriato.

<RichTextBlock>
    <Paragraph>
        <Span xml:space="preserve">
            <Run>This shows a hyperlink in a paragraph of text. You can click it to open </Run><Hyperlink NavigateUri="http://www.bing.com" UnderlineStyle="None" FontWeight="SemiBold"><Italic>Bing</Italic></Hyperlink><Run> in your browser.</Run>
        </Span>
    </Paragraph>
</RichTextBlock>

// Create a RichTextBlock. The hyperlink is part of the content. 
// Set TextWrapping so that the text and the hyperlink wrap if the content is too wide.
RichTextBlock rtb = new RichTextBlock();
rtb.TextWrapping = TextWrapping.Wrap;

// Create a Hyperlink and a Run. 
// The Run provides the visible content of the hyperlink. 
Hyperlink hyperlink = new Hyperlink();
Run run = new Run();
// Set the Text property on the Run. This will be the visible text of the hyperlink.
run.Text = "Bing";
// Set the URI  and other properties for the Hyperlink. 
hyperlink.NavigateUri = new Uri("http://www.bing.com");
hyperlink.UnderlineStyle = UnderlineStyle.None;
hyperlink.FontWeight = Windows.UI.Text.FontWeights.SemiBold;
//Add the Run to Hyperlink.Inlines collection.
hyperlink.Inlines.Add(run);


// Create an Italic element for the hyperlink.            
Italic italic = new Italic();
italic.Inlines.Add(hyperlink);

// Create Run elements for the text around the hyperlinks.
// Set the Text property on the Run elements.
Run run1 = new Run();
Run run2 = new Run();
run1.Text = "This shows a hyperlink in a paragraph of text. You can click it to open ";
run2.Text = " in your browser.";

// Create a Paragraph to hold the RichTextBlock content.
Paragraph paragraph = new Paragraph();

// Add the text elements to the Paragraph.Inlines collection.
paragraph.Inlines.Add(run1);
paragraph.Inlines.Add(italic);
paragraph.Inlines.Add(run2);
//Add the paragraph to the RichTextBlock.
rtb.Blocks.Add(paragraph);
// Add the RichTextBlock to a StackPanel (defined in the XAML page).        
stackPanel.Children.Add(rtb);

Commenti

Collegamento ipertestuale e collegamento ipertestuale

Esistono due modi per aggiungere un collegamento ipertestuale a un'app XAML. Collegamento ipertestuale e HyperlinkButton hanno lo scopo simile di consentire a un utente di avviare un URI specifico usando un'app browser separata.+ Usare un elemento di testo Collegamento ipertestuale inline all'interno di un controllo di testo. Un elemento Hyperlink scorre con altri elementi di testo ed è possibile usarlo in qualsiasi InlineCollection.

• Usa un controllo HyperlinkButton in qualsiasi punto dell'app. HyperlinkButton è un controllo Button specializzato che è possibile usare ovunque si usi un controllo Button. Per altre info, vedi HyperlinkButton.

Collegamento ipertestuale inline

L'elemento Hyperlink consente di aggiungere testo interattivo al contenuto di un controllo TextBlock o RichTextBlock. Il collegamento ipertestuale è derivato dalla classe Inline , quindi è possibile inserirlo all'interno di qualsiasi contenitore con un Oggetto InlineCollection come proprietà Inlines , ad esempio TextBlock, Paragraph o Span.

Passare a un URI

Per usare il collegamento ipertestuale per passare a un URI (Uniform Resource Identifier), impostare la proprietà NavigateUri . Quando un utente fa clic o tocca l'elemento Hyperlink, l'URI (Uniform Resource Identifier) specificato viene aperto nel browser predefinito. Il browser predefinito viene eseguito in un processo separato dalla tua app.

Quando un utente fa clic sul collegamento ipertestuale, il valore della proprietà NavigateUri viene passato a un gestore di sistema per tipi e schemi URI (Uniform Resource Identifier). Il sistema avvia quindi l'app registrata per lo schema dell'URI (Uniform Resource Identifier) fornito per NavigateUri.

Se non si vuole che il collegamento ipertestuale carichi contenuto in un Web browser predefinito (e non si vuole che venga visualizzato un browser), non impostare un valore per NavigateUri. Gestire invece l'evento Click e scrivere codice che esegue le operazioni desiderate.

Gestire l'evento Click

Usa l'evento Click per azioni diverse dall'avvio di un URI (Uniform Resource Identifier) in un browser, ad esempio lo spostamento all'interno dell'app. Ad esempio, se vuoi caricare una nuova pagina dell'app anziché aprire un browser, chiama un metodo Frame.Navigate all'interno del gestore eventi Click per passare alla nuova pagina dell'app. Se si vuole che un URI (Uniform Resource Identifier) esterno venga caricato all'interno di un controllo WebView presente anche nell'app, chiamare WebView.Navigate come parte della logica del gestore Click .

In genere non si gestisce l'evento Click e si specifica un valore NavigateUri , perché rappresentano due modi diversi per usare l'elemento Hyperlink. Se la finalità è aprire l'URI nel browser predefinito ed è stato specificato un valore per NavigateUri, non gestire l'evento Click . Viceversa, se si gestisce l'evento Click , non specificare un NavigateUri.

Non è possibile eseguire alcuna operazione all'interno del gestore eventi Click per impedire al browser predefinito di caricare qualsiasi destinazione valida specificata per NavigateUri; tale azione viene eseguita automaticamente (in modo asincrono) quando il collegamento ipertestuale viene attivato e non può essere annullato dall'interno del gestore eventi Click .

Limitazioni dei collegamenti ipertestuali

Poiché un oggetto Hyperlink non è un oggetto UIElement, non dispone del set di eventi di input degli elementi dell'interfaccia utente, ad esempio Tapped, PointerPressed e così via. In alternativa, un oggetto Hyperlink ha un proprio evento Click , oltre al comportamento implicito del sistema che carica qualsiasi URI (Uniform Resource Identifier) specificato come NavigateUri. Il sistema gestisce tutte le azioni di input che devono richiamare le azioni Hyperlink e genera l'evento Click in risposta.

L'elemento Hyperlink prevede restrizioni per il contenuto che può esistere nella relativa raccolta Inlines. In particolare, un elemento Hyperlink consente solo tipi Run e altri tipi Span che non siano un altro elemento Hyperlink. InlineUIContainer non può trovarsi nell'insieme Inlines di un oggetto Hyperlink. Un tentativo di aggiungere contenuto con restrizioni genera un'eccezione di argomento non valido o un'eccezione di analisi XAML.

Elemento Hyperlink e comportamento per temi e stili

L'elemento Hyperlink non eredita da Control, quindi non è disponibile una proprietà Style o un Template. È possibile modificare le proprietà ereditate da TextElement, ad esempio Foreground o FontFamily, per modificare l'aspetto di un collegamento ipertestuale, ma non è possibile usare uno stile o un modello comune per applicare le modifiche. Invece di usare un modello, valuta la possibilità di usare risorse comuni per i valori delle proprietà di Hyperlink in modo da ottenere coerenza. Alcune proprietà di Hyperlink usano le impostazioni predefinite da un valore di estensione di markup {ThemeResource} fornito dal sistema. In questo modo l'aspetto dell'elemento Hyperlink può variare in modo appropriato quando l'utente cambia il tema di sistema in fase di esecuzione.

Il colore predefinito del collegamento ipertestuale è il colore principale del sistema. Puoi impostare la proprietà Foreground per sostituirlo.

Per impostazione predefinita, Hyperlink è sottolineato. Questa sottolineatura è importante perché consente di soddisfare i requisiti di accessibilità. Gli utenti daltonici usano la sottolineatura per distinguere tra i collegamenti ipertestuali e il testo. Puoi impostare la proprietà UnderlineStyle per disabilitare la sottolineatura. Se si disabilitano le sottolineature, è consigliabile aggiungere un altro tipo di differenza di formattazione per distinguere i collegamenti ipertestuali da altro testo, ad esempio FontWeight o FontStyle.

Cronologia delle versioni

Costruttori

Proprietà

Metodi

Eventi

Si applica a

Vedi anche

• Span
• HyperlinkButton
• RichTextBlock
• TextBlock