Span Clase

Definición

Espacio de nombres:

Microsoft.UI.Xaml.Documents

Agrupa otros elementos de contenido insertados . Clase primaria para Bold, Hyperlink, Italic y Underline.

/// [Microsoft.UI.Xaml.Markup.ContentProperty(Name="Inlines")]
/// [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 Span : Inline

[Microsoft.UI.Xaml.Markup.ContentProperty(Name="Inlines")]
[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 class Span : Inline

Public Class Span
Inherits Inline

<Span .../>
-or-
<Span ...>
  oneOrMoreInlines
</Span>
-or-
<Span ...>
  mixedContent
</Span>

Herencia

Object IInspectable DependencyObject TextElement Inline Span

Derivado

Microsoft.UI.Xaml.Documents.Bold

Microsoft.UI.Xaml.Documents.Hyperlink

Microsoft.UI.Xaml.Documents.Italic

Microsoft.UI.Xaml.Documents.Underline

Atributos

ContentPropertyAttribute ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Comentarios

Puedes usar Span como elemento de objeto en XAML para incluir texto. Esto permite un uso similar a cómo puede usar la span etiqueta en HTML. Para este uso, establecería los atributos admitidos por TextElement , como FontSize o FontFamily, para que pueda aplicar estas decisiones de formato de texto al intervalo de texto incluido. La ejecución tiene una funcionalidad similar para aplicar propiedades TextElement a un intervalo de texto, pero Ejecutar no admite contenido mixto (su propiedad de contenido XAML Run.Text solo puede contener texto, no contenido mixto y más inlines).

Span admite contenido mixto si estableces el contenido en XAML. Esto significa que puedes combinar etiquetas insertadas como Ejecutar, Negrita , etc. con contenido de texto XAML (texto sin formato), sin restricciones en el orden en que deben aparecer etiquetas frente a texto. Todo el texto, ya sea texto sin formato o como incluido en una etiqueta Insertada , se representa en el orden en que el texto se define en el contenido mixto. Por ejemplo, esto es XAML legal:

<RichTextBlock>
  <Paragraph>
    <Span>This is <Bold>mixed content</Bold> with multiple text areas <Italic> and inlines</Italic>.</Span>
  </Paragraph>
</RichTextBlock>

Cuando el contenido mixto se analiza desde XAML y el modelo de objetos de texto se examina en tiempo de ejecución, cualquier área de texto procedente del texto sin formato genera un objeto Run en la posición de orden de lectura adecuada en la clase de colección InlineCollection que permite el acceso en tiempo de ejecución. Ese elemento Run contiene el texto, pero de lo contrario no tiene ninguna propiedad establecida.

Nota:

La colocación de contenido XAML tanto si se admiten etiquetas o texto directamente dentro de un elemento Span porque Span indica que su propiedad Inlines es la propiedad de contenido XAML. Para obtener más información sobre las propiedades de contenido XAML, consulta la sección "Propiedades de contenido XAML" de la guía de sintaxis XAML.

Los elementos Span se suelen usar como elementos dentro de una Clase InlineCollection, ya sea como elementos secundarios de un Paragraph (se convierte en parte de Paragraph.Inlines) o como contenido de otro Span (se convierte en parte de Span.Inlines).

Clases derivadas de span

Span es la clase primaria para varias clases derivadas que definen una región de texto insertada con una convención de formato determinada:

• Negrita
• Hipervínculo
• Cursiva
• El hipervínculo de subrayado habilita un comportamiento de clic que navega a NavigateUri. Las demás clases derivadas de Span se pueden considerar como decoraciones específicas de clase para el texto y no agregan interacción.

Constructores

Span()

Inicializa una nueva instancia de la clase Span .

Propiedades

AccessKey	Obtiene o establece la clave de acceso de este elemento. (Heredado de TextElement)
AccessKeyScopeOwner	Obtiene o establece un elemento de origen que proporciona el ámbito de la clave de acceso para este elemento, incluso si no está en el árbol visual del elemento de origen. (Heredado de TextElement)
AllowFocusOnInteraction	Obtiene o establece un valor que indica si el elemento obtiene automáticamente el foco cuando el usuario interactúa con él. (Heredado de TextElement)
CharacterSpacing	Obtiene o establece el espaciado uniforme entre caracteres, en unidades de 1/1000 de em. (Heredado de TextElement)
ContentEnd	Obtiene un TextPointer que representa el final del contenido del elemento . (Heredado de TextElement)
ContentStart	Obtiene un TextPointer que representa el inicio del contenido en el elemento . (Heredado de TextElement)
Dispatcher	Siempre devuelve null en una aplicación de SDK de Aplicaciones para Windows. En su lugar, use DispatcherQueue . (Heredado de DependencyObject)
DispatcherQueue	Obtiene el objeto DispatcherQueue al que está asociado este objeto. DispatcherQueue representa una instalación que puede tener acceso a DependencyObject en el subproceso de interfaz de usuario incluso si un subproceso que no es de interfaz de usuario inicia el código. (Heredado de DependencyObject)
ElementEnd	Obtiene un TextPointer que representa la posición justo después del final del elemento. (Heredado de TextElement)
ElementStart	Obtiene un TextPointer que representa la posición justo antes del inicio del elemento. (Heredado de TextElement)
ExitDisplayModeOnAccessKeyInvoked	Obtiene o establece un valor que especifica si se descarta la presentación de la clave de acceso cuando se invoca una clave de acceso. (Heredado de TextElement)
FontFamily	Obtiene o establece la familia de fuentes de nivel superior preferida para el contenido del elemento. (Heredado de TextElement)
FontSize	Obtiene o establece el tamaño de fuente para el contenido del elemento. (Heredado de TextElement)
FontStretch	Obtiene o establece el ancho del glifo de la fuente de una familia que se va a seleccionar. (Heredado de TextElement)
FontStyle	Obtiene o establece el estilo de fuente del contenido de este elemento. (Heredado de TextElement)
FontWeight	Obtiene o establece el peso de fuente de nivel superior que se va a seleccionar de la familia de fuentes para el contenido de este elemento. (Heredado de TextElement)
Foreground	Obtiene o establece el pincel que se va a aplicar al contenido de este elemento. (Heredado de TextElement)
Inlines	Obtiene una inlineCollection que contiene los elementos insertados de nivel superior que incluyen el contenido de Span.
IsAccessKeyScope	Obtiene o establece un valor que indica si un elemento define su propio ámbito de clave de acceso. (Heredado de TextElement)
IsTextScaleFactorEnabled	Obtiene o establece si la ampliación automática del texto, para reflejar la configuración del tamaño del texto del sistema, está habilitada. (Heredado de TextElement)
KeyTipHorizontalOffset	Obtiene o establece un valor que indica la distancia izquierda o derecha que se coloca la información sobre claves en relación con el elemento de texto. (Heredado de TextElement)
KeyTipPlacementMode	Obtiene o establece un valor que indica dónde se coloca keyTip en relación con el elemento de texto. (Heredado de TextElement)
KeyTipVerticalOffset	Obtiene o establece un valor que indica hasta dónde se coloca la información sobre claves en relación con el elemento de texto. (Heredado de TextElement)
Language	Obtiene o establece información de idioma de localización o globalización que se aplica a un TextElement. (Heredado de TextElement)
Name	Obtiene o establece una identificación única para el objeto . El nombre solo se puede establecer a partir del análisis inicial de XAML. (Heredado de TextElement)
TextDecorations	Obtiene o establece un valor que indica qué decoraciones se aplican al texto. (Heredado de TextElement)
XamlRoot	Obtiene o establece el xamlRoot en el que se está viendo este elemento. (Heredado de TextElement)

Métodos

ClearValue(DependencyProperty)	Borra el valor local de una propiedad de dependencia. (Heredado de DependencyObject)
FindName(String)	Recupera un objeto en el gráfico de objetos en tiempo de ejecución o modelo de objetos haciendo referencia al valor del atributo x:Name o Name del objeto. (Heredado de TextElement)
GetAnimationBaseValue(DependencyProperty)	Devuelve cualquier valor base establecido para una propiedad de dependencia, que se aplicaría en los casos en los que una animación no está activa. (Heredado de DependencyObject)
GetValue(DependencyProperty)	Devuelve el valor efectivo actual de una propiedad de dependencia de dependencyObject. (Heredado de DependencyObject)
OnDisconnectVisualChildren()	Invalide este método para implementar cómo debe comportarse el diseño y la lógica cuando se quitan elementos de una propiedad secundaria o contenido específico de clase. (Heredado de TextElement)
ReadLocalValue(DependencyProperty)	Devuelve el valor local de una propiedad de dependencia, si se establece un valor local. (Heredado de DependencyObject)
RegisterPropertyChangedCallback(DependencyProperty, DependencyPropertyChangedCallback)	Registra una función de notificación para escuchar los cambios en una dependencyProperty específica en esta instancia de DependencyObject . (Heredado de DependencyObject)
SetValue(DependencyProperty, Object)	Establece el valor local de una propiedad de dependencia en dependencyObject. (Heredado de DependencyObject)
UnregisterPropertyChangedCallback(DependencyProperty, Int64)	Cancela una notificación de cambio registrada anteriormente mediante una llamada a RegisterPropertyChangedCallback. (Heredado de DependencyObject)

Eventos

AccessKeyDisplayDismissed	Se produce cuando se completa la secuencia de claves de acceso para notificar a los controles que deben ocultar los objetos visuales de clave de acceso. (Heredado de TextElement)
AccessKeyDisplayRequested	Se produce cuando se inicia la secuencia de claves de acceso para notificar a los controles que deben mostrar objetos visuales de clave de acceso. (Heredado de TextElement)
AccessKeyInvoked	Se produce cuando un usuario completa una secuencia de claves de acceso para notificar al elemento que se debe invocar la acción de clave de acceso. (Heredado de TextElement)

Consulte también

• Inline
• Paragraph