Hyperlink Klasse

Definition

public ref class Hyperlink sealed : Span

/// [Windows.Foundation.Metadata.Activatable(65536, "Microsoft.UI.Xaml.WinUIContract")]
/// [Windows.Foundation.Metadata.ContractVersion(Microsoft.UI.Xaml.WinUIContract, 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.Activatable(65536, "Microsoft.UI.Xaml.WinUIContract")]
[Windows.Foundation.Metadata.ContractVersion(typeof(Microsoft.UI.Xaml.WinUIContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
public sealed class Hyperlink : Span

Public NotInheritable Class Hyperlink
Inherits Span

<Hyperlink .../>

Vererbung

Object Platform::Object IInspectable DependencyObject TextElement Inline Span Hyperlink

Attribute

ActivatableAttribute ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Beispiele

Hier sehen Sie ein Beispiel für ein einfaches Hyperlink-Element in einem TextBlock.

In XAML ist die Erstellung von Inhaltselementen implizit, sodass Sie den Linktext direkt dem Link und den Hyperlink direkt dem TextBlock-Element hinzufügen können.

Im Code müssen Sie jedes Run-Element explizit erstellen, dessen Text-Eigenschaft festlegen und es der entsprechenden Inlines-Auflistung (entweder hyperlink oder TextBlock) hinzufügen.

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

Dieses Beispiel zeigt ein Hyperlink-Element in einem TextBlock mit anderem Text.

In XAML erfolgt die Erstellung von Inhaltselementen implizit, sodass Sie den Linktext direkt zum Link hinzufügen können. Das Span-Element mit dem xml:space="preserve" -Attribut wird verwendet, um Leerzeichen um den Link beizubehalten.

Im Code müssen Sie jedes Run-Element explizit erstellen, dessen Text-Eigenschaft festlegen und es der entsprechenden Inlines-Auflistung (entweder hyperlink oder TextBlock) hinzufügen.

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

Hier sehen Sie ein Beispiel für ein einfaches Hyperlink-Element in einem TextBlock.

In XAML ist die Erstellung von Inhaltselementen implizit, sodass Sie den Linktext direkt dem Link und den Hyperlink direkt dem TextBlock-Element hinzufügen können. Das Span-Element mit dem xml:space="preserve" -Attribut wird verwendet, um Leerzeichen um den Link beizubehalten.

Im Code müssen Sie jedes Textelement explizit erstellen (z. B. Run, Paragraph oder Italic) und es der entsprechenden Inlines-Auflistung hinzufügen.

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

Hinweise

Hyperlink und HyperlinkButton

Es gibt zwei Möglichkeiten, wie Sie einer XAML-App einen Link hinzufügen können. Hyperlink und HyperlinkButton haben den ähnlichen Zweck, es einem Benutzer zu ermöglichen, einen bestimmten URI mithilfe einer separaten Browser-App zu starten.+ Verwenden Sie ein Inline-Hyperlink-Textelement innerhalb eines Textsteuerelements. Ein Hyperlink-Element fließt mit anderen Textelementen, und Sie können es in jeder InlineCollection verwenden.

• Verwenden Sie ein HyperlinkButton-Steuerelement an einer beliebigen Stelle in der App. Ein HyperlinkButton ist ein spezielles Button-Steuerelement , das Sie überall verwenden können, wo Sie eine Schaltfläche verwenden würden. Weitere Informationen finden Sie unter HyperlinkButton.

Inlinelink

Sie verwenden das Hyperlink-Element, um dem Inhalt eines TextBlock- oder RichTextBlock-Elements interaktiven Text hinzuzufügen. Hyperlink wird von der Inline-Klasse abgeleitet, sodass Sie ihn in jedem Container platzieren können, der eine InlineCollection als Inlines-Eigenschaft aufweist, z. B. TextBlock, Paragraph oder Span.

Navigieren zu einem URI

Um den Link zum Navigieren zu einem URI (Uniform Resource Identifier) zu verwenden, legen Sie die NavigateUri-Eigenschaft fest. Wenn ein Benutzer auf das Hyperlink-Element klickt oder tippt, wird der angegebene URI (Uniform Resource Identifier) im Standardbrowser geöffnet. Der Standardbrowser wird in einem separaten Prozess von Ihrer App ausgeführt.

Wenn ein Benutzer auf den Link klickt, wird der Wert der NavigateUri-Eigenschaft an einen Systemhandler für URI-Typen und -Schemas (Uniform Resource Identifier) übergeben. Das System startet dann die App, die für das Schema des für NavigateUri bereitgestellten URI (Uniform Resource Identifier) registriert ist.

Wenn Sie nicht möchten, dass der Link Inhalt in einem Standardwebbrowser lädt (und kein Browser angezeigt werden soll), legen Sie keinen Wert für NavigateUri fest. Behandeln Sie stattdessen das Click-Ereignis , und schreiben Sie Code, der ihre Wünsche erfüllt.

Behandeln des Click-Ereignisses

Verwenden Sie das Click-Ereignis für andere Aktionen als das Starten eines URI (Uniform Resource Identifier) in einem Browser, z. B. die Navigation innerhalb der App. Wenn Sie beispielsweise eine neue App-Seite laden möchten, anstatt einen Browser zu öffnen, rufen Sie eine Frame.Navigate-Methode in Ihrem Click-Ereignishandler auf, um zur neuen App-Seite zu navigieren. Wenn ein externer, absoluter URI (Uniform Resource Identifier) innerhalb eines WebView2-Steuerelements geladen werden soll, das auch in Ihrer App vorhanden ist, rufen Sie WebView2.NavigateToString(System.String) als Teil Ihrer Click-Handlerlogik auf.

Sie behandeln in der Regel nicht das Click-Ereignis und geben einen NavigateUri-Wert an, da diese zwei verschiedene Möglichkeiten zur Verwendung des Hyperlink-Elements darstellen. Wenn Sie den URI im Standardbrowser öffnen möchten und Sie einen Wert für NavigateUri angegeben haben, behandeln Sie das Click-Ereignis nicht. Wenn Sie dagegen das Click-Ereignis behandeln, geben Sie keinen NavigateUri an.

Es gibt nichts, was Sie innerhalb des Click-Ereignishandlers tun können, um zu verhindern, dass der Standardbrowser ein gültiges Ziel lädt, das für NavigateUri angegeben ist. Diese Aktion wird automatisch (asynchron) ausgeführt, wenn der Link aktiviert wird, und kann nicht innerhalb des Click-Ereignishandlers abgebrochen werden.

Hyperlink-Einschränkungen

Da ein Link kein UIElement ist, verfügt er nicht über den Satz von Eingabeereignissen für UI-Elemente wie Tapped, PointerPressed usw. Stattdessen verfügt ein Hyperlink über ein eigenes Click-Ereignis sowie das implizite Verhalten des Systems beim Laden eines URI (Uniform Resource Identifier), der als NavigateUri angegeben ist. Das System verarbeitet alle Eingabeaktionen, die die Hyperlinkaktionen aufrufen sollen, und löst als Antwort das Click-Ereignis aus.

Für den Link liegen Einschränkungen in Bezug auf den Inhalt vor, der in der Inlines-Sammlung enthalten sein darf. Genauer gesagt: Ein Link lässt nur Run- und andere Span-Typen zu, die keinen anderen Link darstellen. InlineUIContainer darf sich nicht in der Inlines-Auflistung eines Hyperlinks befinden. Beim Versuch, eingeschränkte Inhalte hinzuzufügen, wird eine Ausnahme für ein ungültiges Argument oder eine XAML-Analyseausnahme ausgelöst.

Links und Design-/Formatvorlagenverhalten

Links erben nicht von Control. Daher enthalten sie keine Style- oder Template-Eigenschaft. Sie können die eigenschaften bearbeiten, die von TextElement geerbt werden, z. B. Vordergrund oder FontFamily, um die Darstellung eines Links zu ändern, aber Sie können keine allgemeinen Stile oder Vorlagen verwenden, um Änderungen anzuwenden. Verwenden Sie anstelle einer Vorlage allgemeine Ressourcen für Werte der Linkeigenschaften, um die Konsistenz zu gewährleisten. Einige Eigenschaften von Hyperlink verwenden Standardwerte aus einem {ThemeResource}-Markuperweiterungswert , der vom System bereitgestellt wird. Dadurch kann die Linkdarstellung entsprechend angepasst werden, wenn der Benutzer das Systemdesign während der Laufzeit ändert.

Die Standardfarbe des Links ist die Akzentfarbe des Systems. Dieses Verhalten können Sie mit der Foreground-Eigenschaft außer Kraft setzen.

Standardmäßig ist Hyperlink unterstrichen. Diese Unterstreichung ist wichtig, da dadurch Anforderungen für Barrierefreiheit erfüllt werden. Farbenblinde Benutzer können anhand der Unterstreichung zwischen Links und anderem Text unterscheiden. Sie können die UnderlineStyle-Eigenschaft festlegen, um die Unterstreichung zu deaktivieren. Wenn Sie Unterstrichen deaktivieren, sollten Sie eine andere Art von Formatierungsunterschied hinzufügen, um Links von anderen Texten zu unterscheiden, z. B. FontWeight oder FontStyle.

Konstruktoren

Eigenschaften

Methoden

Ereignisse

Gilt für:

Weitere Informationen

• Span
• HyperlinkButton
• RichTextBlock
• TextBlock