Compartir a través de


Run Clase

Definición

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

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

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)

Se aplica a

Consulte también