Run Classe

Definição

Namespace:

Windows.UI.Xaml.Documents

Representa uma seção discreta de texto formatado ou não formatado.

public ref class Run sealed : 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.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 : Inline

Public NotInheritable Class Run
Inherits Inline

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

Herança

Object Platform::Object IInspectable DependencyObject TextElement Inline Run

Atributos

ActivatableAttribute ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute ContentPropertyAttribute

Requisitos do Windows

Família de dispositivos	Windows 10 (introduzida na 10.0.10240.0)
API contract	Windows.Foundation.UniversalApiContract (introduzida na v1.0)

Exemplos

Cada exemplo mostrado aqui renderiza o mesmo resultado. No entanto, definir a propriedade Text diretamente no TextBlock tem o melhor desempenho.

<!-- 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);

Comentários

Uma Execução representa uma seção discreta de texto formatado ou não formatado e pode ser usado em um TextBlock ou RichTextBlock. Você pode colocar vários elementos Run dentro de um Span.

Ao usar um TextBlock, defina a propriedade TextBlock.Text diretamente para melhor desempenho. Normalmente, você usa o elemento Run somente quando deseja formatar uma seção discreta do texto no TextBlock.

Para obter mais exemplos, consulte

• TextBlock
• Guia de controle TextBlock
• RichTextBlock
• Guia de controle RichTextBlock

Construtores

Run()

Inicializa uma nova instância da classe Run .

Propriedades

AccessKey	Obtém ou define a chave de acesso para esse elemento. (Herdado de TextElement)
AccessKeyScopeOwner	Obtém ou define um elemento de origem que fornece o escopo da chave de acesso para esse elemento, mesmo que ele não esteja na árvore visual do elemento de origem. (Herdado de TextElement)
AllowFocusOnInteraction	Obtém ou define um valor que indica se o elemento obtém automaticamente o foco quando o usuário interage com ele. (Herdado de TextElement)
CharacterSpacing	Obtém ou define o espaçamento uniforme entre caracteres, em unidades de 1/1000 de um em. (Herdado de TextElement)
ContentEnd	Obtém um TextPointer que representa o final do conteúdo no elemento . (Herdado de TextElement)
ContentStart	Obtém um TextPointer que representa o início do conteúdo no elemento . (Herdado de TextElement)
Dispatcher	Obtém o CoreDispatcher ao qual esse objeto está associado. O CoreDispatcher representa uma instalação que pode acessar DependencyObject no thread da interface do usuário mesmo que o código seja iniciado por um thread que não seja da interface do usuário. (Herdado de DependencyObject)
ElementEnd	Obtém um TextPointer que representa a posição logo após o final do elemento. (Herdado de TextElement)
ElementStart	Obtém um TextPointer que representa a posição pouco antes do início do elemento. (Herdado de TextElement)
ExitDisplayModeOnAccessKeyInvoked	Obtém ou define um valor que especifica se a exibição da chave de acesso é ignorada quando uma chave de acesso é invocada. (Herdado de TextElement)
FlowDirection	Obtém ou define a direção que o texto e outros elementos da interface do usuário fluem dentro do elemento Run que controla seu layout.
FlowDirectionProperty	Identifica a propriedade de dependência FlowDirection .
FontFamily	Obtém ou define a família de fontes preferencial de nível superior para o conteúdo do elemento. (Herdado de TextElement)
FontSize	Obtém ou define o tamanho da fonte para o conteúdo do elemento. (Herdado de TextElement)
FontStretch	Obtém ou define a largura do glifo da fonte em uma família a ser selecionada. (Herdado de TextElement)
FontStyle	Obtém ou define o estilo da fonte para o conteúdo neste elemento. (Herdado de TextElement)
FontWeight	Obtém ou define o peso da fonte de nível superior a ser selecionado na família de fontes para o conteúdo neste elemento. (Herdado de TextElement)
Foreground	Obtém ou define o Pincel a ser aplicado ao conteúdo neste elemento. (Herdado de TextElement)
IsAccessKeyScope	Obtém ou define um valor que indica se um elemento define seu próprio escopo de chave de acesso. (Herdado de TextElement)
IsTextScaleFactorEnabled	Obtém ou define se a ampliação automática de texto, para refletir a configuração de tamanho do texto do sistema, está habilitada. (Herdado de TextElement)
KeyTipHorizontalOffset	Obtém ou define um valor que indica o quão à esquerda ou à direita a dica de chave é colocada em relação ao elemento de texto. (Herdado de TextElement)
KeyTipPlacementMode	Obtém ou define um valor que indica onde a Dica de Chave é colocada em relação ao elemento de texto. (Herdado de TextElement)
KeyTipVerticalOffset	Obtém ou define um valor que indica até que ponto a dica de chave é colocada em relação ao elemento de texto. (Herdado de TextElement)
Language	Obtém ou define informações de idioma de localização/globalização que se aplicam a um TextElement. (Herdado de TextElement)
Name	Obtém ou define uma identificação exclusiva para o objeto . O nome só pode ser definido a partir da análise inicial de XAML. (Herdado de TextElement)
Text	Obtém ou define o conteúdo do texto da execução.
TextDecorations	Obtém ou define um valor que indica quais decorações são aplicadas ao texto. (Herdado de TextElement)
XamlRoot	Obtém ou define o XamlRoot no qual esse elemento está sendo exibido. (Herdado de TextElement)

Métodos

ClearValue(DependencyProperty)	Limpa o valor local de uma propriedade de dependência. (Herdado de DependencyObject)
FindName(String)	Recupera um objeto no modelo de objeto/grafo de objeto de runtime fazendo referência ao valor do atributo x:Name ou Name do objeto. (Herdado de TextElement)
GetAnimationBaseValue(DependencyProperty)	Retorna qualquer valor base estabelecido para uma propriedade de dependência, que se aplicaria nos casos em que uma animação não está ativa. (Herdado de DependencyObject)
GetValue(DependencyProperty)	Retorna o valor efetivo atual de uma propriedade de dependência de um DependencyObject. (Herdado de DependencyObject)
OnDisconnectVisualChildren()	Substitua esse método para implementar como o layout e a lógica devem se comportar quando os itens são removidos de um conteúdo específico da classe ou propriedade filho. (Herdado de TextElement)
ReadLocalValue(DependencyProperty)	Retorna o valor local de uma propriedade de dependência, se um valor local for definido. (Herdado de DependencyObject)
RegisterPropertyChangedCallback(DependencyProperty, DependencyPropertyChangedCallback)	Registra uma função de notificação para escutar alterações em uma DependencyProperty específica nesta instância dependencyObject . (Herdado de DependencyObject)
SetValue(DependencyProperty, Object)	Define o valor local de uma propriedade de dependência em um DependencyObject. (Herdado de DependencyObject)
UnregisterPropertyChangedCallback(DependencyProperty, Int64)	Cancela uma notificação de alteração que foi registrada anteriormente chamando RegisterPropertyChangedCallback. (Herdado de DependencyObject)

Eventos

AccessKeyDisplayDismissed	Ocorre quando a sequência de chaves de acesso é concluída para notificar os controles de que eles devem ocultar visuais de chave de acesso. (Herdado de TextElement)
AccessKeyDisplayRequested	Ocorre quando a sequência de chaves de acesso é iniciada para notificar os controles de que eles devem mostrar visuais de chave de acesso. (Herdado de TextElement)
AccessKeyInvoked	Ocorre quando um usuário conclui uma sequência de chaves de acesso para notificar o elemento de que a ação de chave de acesso deve ser invocada. (Herdado de TextElement)

Confira também

• Inline
• TextBlock
• RichTextBlock