Run Clase
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
Representa una sección discreta de texto con formato o sin formato.
public ref class Run sealed : Inline/// [Windows.Foundation.Metadata.Activatable(65536, Windows.Foundation.UniversalApiContract)]
/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
/// [Windows.UI.Xaml.Markup.ContentProperty(Name="Text")]
class Run final : Inline/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
/// [Windows.UI.Xaml.Markup.ContentProperty(Name="Text")]
/// [Windows.Foundation.Metadata.Activatable(65536, "Windows.Foundation.UniversalApiContract")]
class Run final : Inline[Windows.Foundation.Metadata.Activatable(65536, typeof(Windows.Foundation.UniversalApiContract))]
[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
[Windows.UI.Xaml.Markup.ContentProperty(Name="Text")]
public sealed class Run : Inline[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
[Windows.UI.Xaml.Markup.ContentProperty(Name="Text")]
[Windows.Foundation.Metadata.Activatable(65536, "Windows.Foundation.UniversalApiContract")]
public sealed class Run : InlinePublic NotInheritable Class Run
Inherits Inline<Run .../>
-or-
<Run ...>text</Run>
- Herencia
- Atributos
Requisitos de Windows
| Familia de dispositivos |
Windows 10 (se introdujo en la versión 10.0.10240.0)
|
| API contract |
Windows.Foundation.UniversalApiContract (se introdujo en la versión v1.0)
|
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 |
Obtiene el CoreDispatcher al que está asociado este objeto. CoreDispatcher 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) |
| 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) |