Run Clase

Definición

Espacio de nombres:

Microsoft.UI.Xaml.Documents

Representa una sección discreta de texto con formato o sin formato.

public ref class Run sealed : Inline

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

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

Public NotInheritable Class Run
Inherits Inline

<Run .../>
-or-
<Run ...>text</Run>

Herencia

Object Platform::Object IInspectable DependencyObject TextElement Inline Run

Atributos

ContentPropertyAttribute ActivatableAttribute ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Ejemplos

Cada ejemplo que se muestra aquí representa el mismo resultado. Sin embargo, establecer la propiedad Text directamente en TextBlock tiene el mejor rendimiento.

<!-- Set the TextBlock.Text property directy for best performance. -->
<TextBlock Text="This is some text."/>

<TextBlock><Run>This is some text.</Run></TextBlock>

<TextBlock><Run Text="This is some text."></Run></TextBlock>

// Set the TextBlock.Text property directy for best performance.
TextBlock textblock = new TextBlock();
textblock.Text = "This is some text.";

TextBlock textblock = new TextBlock();
Run run = new Run();
run.Text = "This is some text.";
textblock.Inlines.Add(run);

Comentarios

Una ejecución representa una sección discreta de texto con formato o sin formato y se puede usar en un TextBlock o RichTextBlock. Puede colocar varios elementos Run dentro de un intervalo.

Cuando se usa un TextBlock, establezca la propiedad TextBlock.Text directamente para obtener el mejor rendimiento. Normalmente, solo se usa el elemento Run cuando se desea dar formato a una sección discreta del texto dentro de TextBlock.

Para ver más ejemplos, consulte

• TextBlock
• Guía de control TextBlock
• RichTextBlock
• Guía de control RichTextBlock

Constructores

Run()

Inicializa una nueva instancia de la clase Run .

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, aunque 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 un elemento 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. Use DispatcherQueue en su lugar. (Heredado de DependencyObject)
DispatcherQueue	Obtiene el objeto DispatcherQueue al que está asociado este objeto. DispatcherQueue representa una instalación que puede acceder al 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)
FlowDirection	Obtiene o establece la dirección en la que fluyen el texto y otros elementos de la interfaz de usuario dentro del elemento Run que controla su diseño.
FlowDirectionProperty	Identifica la propiedad de dependencia FlowDirection .
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 para el contenido de este elemento. (Heredado de TextElement)
FontWeight	Obtiene o establece el peso de fuente de nivel superior que se va a seleccionar en la familia de fuentes del 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)
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 de 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 la información sobre claves en relación con el elemento de texto. (Heredado de TextElement)
KeyTipVerticalOffset	Obtiene o establece un valor que indica la distancia hacia arriba o hacia abajo de 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)
Text	Obtiene o establece el contenido del texto de la ejecución.
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 los elementos se quitan 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 llamando a RegisterPropertyChangedCallback. (Heredado de DependencyObject)

Eventos

AccessKeyDisplayDismissed	Se produce cuando la secuencia de claves de acceso se completa 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
• TextBlock
• RichTextBlock