Hipervínculo Class

Proporciona un elemento de contenido insertado que proporciona los medios para hospedar hipervínculos.

Herencia

Object
  DependencyObject
    TextElement
      Inline
        Span
          Hyperlink

Sintaxis


public sealed class Hyperlink : Span

Atributos

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

Members

A continuación se indican los tipos de miembros de Hyperlink (Clase):

Constructores

A continuación se indican los constructores de Hyperlink (Clase).

ConstructorDescripción
Hyperlink Initializes a new instance of the Hyperlink class.

 

Eventos

A continuación se indican los eventos de Hyperlink (Clase).

EventoDescripción
Click Occurs when the Hyperlink is clicked.

 

Métodos

The Hyperlink Clase tiene estos métodos. También hereda métodos de Object Clase.

MétodoDescripción
ClearValue Clears the local value of a dependency property. (Se hereda de DependencyObject)
FindName Retrieves an object in the object model / runtime object graph by referencing the object's x:Name or Name attribute value. (Se hereda de TextElement)
GetAnimationBaseValue Returns any base value established for a dependency property, which would apply in cases where an animation is not active. (Se hereda de DependencyObject)
GetValue Returns the current effective value of a dependency property from a DependencyObject. (Se hereda de 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. (Se hereda de TextElement)
ReadLocalValue Returns the local value of a dependency property, if a local value is set. (Se hereda de DependencyObject)
SetValue Sets the local value of a dependency property on a DependencyObject. (Se hereda de DependencyObject)

 

Propiedades

HyperlinkClase tiene estas propiedades.

PropiedadTipo de accesoDescripción

CharacterSpacing

Lectura/escrituraGets or sets the uniform spacing between characters, in units of 1/1000 of an em. (Se hereda de TextElement)

ContentEnd

De sólo lecturaGets a TextPointer that represents the end of the content in the element. (Se hereda de TextElement)

ContentStart

De sólo lecturaGets a TextPointer that represents the start of content in the element. (Se hereda de TextElement)

Dispatcher

De sólo lecturaGets the CoreDispatcher that this object is associated with. (Se hereda de DependencyObject)

ElementEnd

De sólo lecturaGets a TextPointer that represents the position just after the end of the element. (Se hereda de TextElement)

ElementStart

De sólo lecturaGets a TextPointer that represents the position just before the start of the element. (Se hereda de TextElement)

FontFamily

Lectura/escrituraGets or sets the preferred top-level font family for the content of the element. (Se hereda de TextElement)

FontSize

Lectura/escrituraGets or sets the font size for the content of the element. (Se hereda de TextElement)

FontStretch

Lectura/escrituraGets or sets the glyph width of the font in a family to select. (Se hereda de TextElement)

FontStyle

Lectura/escrituraGets or sets the font style for the content in this element. (Se hereda de TextElement)

FontWeight

Lectura/escrituraGets or sets the top-level font weight to select from the font family for the content in this element. (Se hereda de TextElement)

Foreground

Lectura/escrituraGets or sets the Brush to apply to the content in this element. (Se hereda de TextElement)

Inlines

Lectura/escrituraGets an InlineCollection containing the top-level inline elements that include the contents of Span. (Se hereda de Span)

Language

Lectura/escrituraGets or sets localization/globalization language information that applies to a TextElement. (Se hereda de TextElement)

Name

De sólo lecturaGets or sets a unique identification for the object. Name can only be set from initial parsing of XAML. (Se hereda de TextElement)

NavigateUri

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

NavigateUriProperty

De sólo lecturaIdentifies the NavigateUri dependency property.

 

Comentarios

Un elemento Hyperlink es una clase derivada de Inline. Esto significa que se puede colocar en una colección InlineCollection. Está pensado para que forme parte del contenido de texto de un RichTextBlock o RichEditBox, pero dentro de otros contenedores de texto. Por ejemplo, un elemento de objeto Hyperlink en XAML puede ser uno de los elementos dentro del contenido de un Paragraph, donde el contenido XAML pasa a formar parte de la InlineCollection implícita para la propiedad de contenido XAML Inlines del Paragraph. Un Hyperlink también puede estar dentro de un contenedor de Span.

La propiedad o atributo que establece para especificar el destino de la navegación de un Hyperlink es NavigateUri. Cuando el usuario puntea un elemento Hyperlink, se pasa el valor de NavigateUri a un controlador del sistema para esquemas y tipos de identificador uniforme de recursos (URI). A continuación, el sistema inicia la aplicación registrada para el esquema del URI proporcionado para NavigateUri.

Dada que un Hyperlink no es un UIElement no tiene el conjunto de eventos de entrada de elementos de la interfaz de usuario como Tapped, PointerPressed y así sucesivamente. En su lugar, un Hyperlink tiene su propio evento Click. El sistema controla todas las acciones de entrada que deben invocar acciones Hyperlink y desencadena el evento Click como respuesta.

Comportamiento de hipervínculo y tema/estilo

Un Hyperlink tiene una herencia de clases que no incluye FrameworkElement, así que no tiene una propiedad Style. Ni Hyperlink tiene una Template (no es exactamente un control). Puede editar las propiedades heredadas del objeto TextElement como Foreground o FontFamily para cambiar la apariencia de un objeto Hyperlink, pero no puede utilizar una plantilla o un estilo común para aplicar los cambios. Si utiliza valores de propiedades distintos de los predeterminados, puede considerar la posibilidad de utilizar recursos comunes para los valores de las propiedades Hyperlink para proporcionar cierta coherencia a los valores de sus propiedades Hyperlink. Algunas propiedades de Hyperlink como Foreground usan valores predeterminados de un valor de ThemeResource proporcionado por el sistema. Esto permite cambiar la apariencia del objeto Hyperlink según convenga cuando el usuario cambie el tema del sistema en tiempo de ejecución.

Hyperlink y HyperlinkButton

Un Hyperlink y un HyperlinkButton tienen el propósito similar de permitir a un usuario iniciar un URI específico mediante una aplicación independiente del explorador. La diferencia entre ellos es que un Hyperlink es un elemento de texto que se puede colocar en texto con formato (por ejemplo, en RichTextBlock) y un HyperlinkButton es un control que se puede colocar dentro de cualquier contenedor de diseño que acepta controles o elementos de la interfaz de usuario. Un HyperlinkButton se puede utilizar dentro de la composición o plantilla de un control personalizado que permite una experiencia de navegación web.

Requisitos

Cliente mínimo admitido

Windows 8.1 [Solo aplicaciones de la Tienda Windows]

Servidor mínimo admitido

Windows Server 2012 R2 [Solo aplicaciones de la Tienda Windows]

Espacio de nombres

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

Metadatos

Windows.winmd

Vea también

Span

 

 

Mostrar:
© 2014 Microsoft