Classe Hyperlink

Collegamento ipertestuale Class

Fornisce un elemento del contenuto di livello inline che fornisce funzionalità per l'hosting di collegamenti ipertestuali.

Ereditarietà

Object
  DependencyObject
    TextElement
      Inline
        Span
          Hyperlink

Sintassi


Public NotInheritable Class Hyperlink
    Inherits Span

Attributi

[MarshalingBehavior(Agile)]
[Threading(Both)]
[Version(0x06030000)]
[WebHostHidden()]

Membri

HyperlinkClasse include questi tipi di membri:

Costruttori

HyperlinkClasse include questi costruttori.

CostruttoreDescrizione
Hyperlink Initializes a new instance of the Hyperlink class.

 

Eventi

HyperlinkClasse include questi eventi.

EventoDescrizione
Click Occurs when the Hyperlink is clicked.

 

Metodi

The Hyperlink Classe dispone di tali metodi. Eredita inoltre i metodi da Object Classe.

MetodoDescrizione
ClearValue Clears the local value of a dependency property. (Ereditata da DependencyObject)
FindName Retrieves an object in the object model / runtime object graph by referencing the object's x:Name or Name attribute value. (Ereditata da TextElement)
GetAnimationBaseValue Returns any base value established for a dependency property, which would apply in cases where an animation is not active. (Ereditata da DependencyObject)
GetValue Returns the current effective value of a dependency property from a DependencyObject. (Ereditata da DependencyObject)
OnDisconnectVisualChildren Override this method to implement how layout and logic should behave when items are removed from a class-specific content or child property. (Ereditata da TextElement)
ReadLocalValue Returns the local value of a dependency property, if a local value is set. (Ereditata da DependencyObject)
SetValue Sets the local value of a dependency property on a DependencyObject. (Ereditata da DependencyObject)

 

Proprietà

Classe dispone di tali proprietà. di Hyperlink

ProprietàTipo di accessoDescrizione

CharacterSpacing

Lettura/scritturaGets or sets the uniform spacing between characters, in units of 1/1000 of an em. (Ereditata da TextElement)

ContentEnd

Sola letturaGets a TextPointer that represents the end of the content in the element. (Ereditata da TextElement)

ContentStart

Sola letturaGets a TextPointer that represents the start of content in the element. (Ereditata da TextElement)

Dispatcher

Sola letturaGets the CoreDispatcher that this object is associated with. (Ereditata da DependencyObject)

ElementEnd

Sola letturaGets a TextPointer that represents the position just after the end of the element. (Ereditata da TextElement)

ElementStart

Sola letturaGets a TextPointer that represents the position just before the start of the element. (Ereditata da TextElement)

FontFamily

Lettura/scritturaGets or sets the preferred top-level font family for the content of the element. (Ereditata da TextElement)

FontSize

Lettura/scritturaGets or sets the font size for the content of the element. (Ereditata da TextElement)

FontStretch

Lettura/scritturaGets or sets the glyph width of the font in a family to select. (Ereditata da TextElement)

FontStyle

Lettura/scritturaGets or sets the font style for the content in this element. (Ereditata da TextElement)

FontWeight

Lettura/scritturaGets or sets the top-level font weight to select from the font family for the content in this element. (Ereditata da TextElement)

Foreground

Lettura/scritturaGets or sets the Brush to apply to the content in this element. (Ereditata da TextElement)

Inlines

Lettura/scritturaGets an InlineCollection containing the top-level inline elements that include the contents of Span. (Ereditata da Span)

Language

Lettura/scritturaGets or sets localization/globalization language information that applies to a TextElement. (Ereditata da TextElement)

Name

Sola letturaGets or sets a unique identification for the object. Name can only be set from initial parsing of XAML. (Ereditata da TextElement)

NavigateUri

Lettura/scritturaGets or sets the Uniform Resource Identifier (URI) to navigate to when the Hyperlink is activated.

NavigateUriProperty

Sola letturaIdentifies the NavigateUri dependency property.

 

Note

Un elemento Hyperlink è una classe derivata da Inline. Ciò significa che può essere inserito in InlineCollection. È destinato a far parte del contenuto di testo di un elemento RichTextBlock o RichEditBox, ma in altri contenitori di testo. Ad esempio un elemento oggetto Hyperlink in XAML può essere uno degli elementi all'interno del contenuto di un elemento Paragraph, il cui contenuto XAML diventa parte dell'elemento InlineCollection implicito per la proprietà di contenuto XAML Inlines dell'elemento Paragraph. Hyperlink può essere anche all'interno di un contenitore Span.

La proprietà/attributo impostata/o per specificare la destinazione di navigazione di un elemento Hyperlink è NavigateUri. Quando un utente tocca un elemento Hyperlink, il valore di NavigateUri viene passato a un gestore di sistema per tipi e schemi Uniform Resource Identifier (URI). Il sistema lancia quindi l'applicazione registrata per lo schema dell'URI fornito per NavigateUri.

Poiché 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. Al contrario un elemento Hyperlink dispone del relativo evento Click. Il sistema gestisce tutte le azioni di input che devono richiamare le azioni Hyperlink e genera Click in risposta.

Comportamento di collegamento ipertestuale e tema/stile

Hyperlink ha un'ereditarietà di classe che non include FrameworkElement, pertanto non dispone di una proprietà Style. Un elemento Hyperlink non ha neppure un elemento Template (non è un vero controllo). È possibile modificare le proprietà ereditate da TextElement, ad esempio Foreground o FontFamily per modificare l'aspetto di Hyperlink, ma non è possibile utilizzare uno stile o un modello comune per applicare le modifiche. Può essere utile considerare l'utilizzo di risorse comuni per i valori delle proprietà Hyperlink per fornire coerenza ai valori della proprietà Hyperlink, se si utilizzano valori di proprietà diversi da quelli predefiniti. Alcune proprietà di Hyperlink, ad esempio Foreground, utilizzano valori predefiniti da un valore ThemeResource fornito dal sistema. Ciò consente la modifica dell'aspetto dell'elemento Hyperlink in modo appropriato quando l'utente modifica il tema di sistema in fase di esecuzione.

Hyperlink e HyperlinkButton

Un oggetto Hyperlink e un oggetto HyperlinkButton hanno lo scopo analogo di consentire a un utente di avviare un URI specifico mediante un'applicazione di browser separata. La differenza è data dal fatto che Hyperlink è un elemento di testo che può essere inserito nel testo formattato (ad esempio in RichTextBlock) e HyperlinkButton è un controllo che può essere inserito in qualsiasi contenitore di layout che accetta elementi o controlli dell'interfaccia utente. HyperlinkButton potrebbe essere utilizzato all'interno della composizione/modello di controllo personalizzato che abilita l'esperienza di esplorazione Web.

Requisiti

Client supportato minimo

Windows 8.1 [Solo applicazioni Windows Store]

Server supportato minimo

Windows Server 2012 R2 [Solo applicazioni Windows Store]

Spazio dei nomi

Windows.UI.Xaml.Documents
Windows::UI::Xaml::Documents [C++]

Metadati

Windows.winmd

Vedere anche

Span

 

 

Mostra:
© 2016 Microsoft