Run Classe
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Representa uma seção discreta de texto formatado ou não formatado.
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 : InlinePublic NotInheritable Class Run
Inherits Inline<Run .../>
-or-
<Run ...>text</Run>
- Herança
- Atributos
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 usada 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 obter o melhor desempenho. Normalmente, você usa o elemento Run somente quando deseja formatar uma seção discreta de texto no TextBlock.
Para obter mais exemplos, consulte
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 |
Sempre retorna |
| DispatcherQueue |
Obtém o ao |
| 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 em 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 Brush 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 referenciando o 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 nessa 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 teclas 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 da chave de acesso deve ser invocada. (Herdado de TextElement) |