TextElement 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.
public ref class TextElement : DependencyObject/// [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)]
class TextElement : DependencyObject[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)]
public class TextElement : DependencyObjectPublic Class TextElement
Inherits DependencyObject- Herança
- Derivado
- Atributos
Requisitos do Windows
| Família de dispositivos |
Windows 10 (introduzida na 10.0.10240.0)
|
| API contract |
Windows.Foundation.UniversalApiContract (introduzida na v1.0)
|
Comentários
As várias propriedades definidas por TextElement dão suporte a uma API comum para classes envolvidas no modelo de objeto de texto XAML. Aqui está uma lista das propriedades mais usadas:
Ao definir as propriedades TextElement, você pode aplicar propriedades comuns de formatação de texto ao texto, tanto em blocos quanto em linhas embutidas. Também há maneiras adicionais de formatar texto, mas elas não têm suporte direto do TextElement. Em vez disso, você pode usar as propriedades anexadas da classe Typography . As propriedades anexadas à tipografia normalmente dão suporte a recursos ou convenções tipográficas avançadas, como acessar recursos tipográficos definidos no nível da fonte que não são necessariamente compatíveis com todas as fontes. Por exemplo, você pode definir Typography.Variants como uma propriedade anexada em qualquer bloco de texto ou embutido, e isso influenciaria o comportamento de variantes de fonte, conforme habilitado pela fonte específica que você escolheu para definir FontFamily nesse elemento de texto.
TextElement não define inerentemente um ponto de conexão para uma árvore visual XAML. Em outras palavras, um TextElement define o modelo de objeto de texto e texto dentro desse texto, mas ainda não habilita a exibição desse texto em uma interface do usuário. Para isso, você precisa usar um dos controles ou elementos descendentes de UIElement e pode ser conectado à árvore XAML e ao visual raiz da janela do aplicativo. Há dois desses elementos no Windows Runtime:
- TextBlock: dá suporte a um modelo de objeto de texto de linhas embutidas somente com sua coleção Inlines .
- RichTextBlock: dá suporte a um modelo de objeto de texto de bloco com sua coleção Blocks . Os blocos podem conter blocos e linhas embutidas.
Observação
PasswordBox, RichEditBox e TextBox não dão suporte a um modelo de objeto de texto baseado em TextElement. RichEditBox habilita o acesso programático a um modelo de objeto de texto diferente por meio da interface ITextDocument .
TextElement define a API que dá suporte ao exame do modelo de objeto de texto como objetos de programação depois que o XAML é analisado. Em particular, TextElement implementa Nome e Linguagem, quais propriedades paralelas de mesmo nome no FrameworkElement. TextElement também implementa FindName (um método utilitário para localizar objetos em tempo de execução com base em como Name foi definido no XAML inicial) e OnDisconnectVisualChildren (para cenários avançados e suporte ao designer).
TextElement tem quatro propriedades que fornecem acesso a objetos TextPointer de dentro do texto. Essas propriedades são: ContentStart, ContentEnd, ElementStart, ElementEnd. Um Windows Runtime objeto TextPointer fornece um ponto de entrada para a passagem de conteúdo. Para obter mais informações, consulte TextPointer.
TextElement é uma classe derivada de DependencyObject. Isso significa que ele pode definir propriedades de dependência e cada uma das propriedades de leitura/gravação de TextElement é uma propriedade de dependência, com seu identificador de propriedade também definido por TextElement. Para obter mais informações sobre quais propriedades de dependência habilitam, consulte Visão geral das propriedades de dependência.
Classes derivadas de TextElement
TextElement é a classe pai de duas classes derivadas que dividem o modelo de objeto de texto em duas convenções de uso de texto: Block e Inline. Block e Inline são ambas classes base consideradas (normalmente você não vê uma <Block> marca em XAML) e existem na hierarquia principalmente para ser a classe pai de outros elementos práticos de texto. Por exemplo, Block é a classe pai de Paragraph. Para obter mais informações sobre como usar elementos de bloco e embutidos, consulte Início Rápido: Exibindo texto.
Histórico de versão
| Versão do Windows | Versão do SDK | Valor adicionado |
|---|---|---|
| 1607 | 14393 | AccessKey |
| 1607 | 14393 | AllowFocusOnInteraction |
| 1607 | 14393 | ExitDisplayModeOnAccessKeyInvoked |
| 1703 | 15063 | AccessKeyDisplayDismissed |
| 1703 | 15063 | AccessKeyDisplayRequested |
| 1703 | 15063 | AccessKeyInvoked |
| 1703 | 15063 | AccessKeyScopeOwner |
| 1703 | 15063 | IsAccessKeyScope |
| 1703 | 15063 | KeyTipHorizontalOffset |
| 1703 | 15063 | KeyTipPlacementMode |
| 1703 | 15063 | KeyTipVerticalOffset |
| 1703 | 15063 | Textdecorations |
| 1903 | 18362 | XamlRoot |
Propriedades
| AccessKey |
Obtém ou define a chave de acesso para esse elemento. |
| AccessKeyProperty |
Identifica a propriedade de dependência AccessKey . |
| 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. |
| AccessKeyScopeOwnerProperty |
Identifica a propriedade de dependência AccessKeyScopeOwner . |
| AllowFocusOnInteraction |
Obtém ou define um valor que indica se o elemento obtém automaticamente o foco quando o usuário interage com ele. |
| AllowFocusOnInteractionProperty |
Identifica a propriedade de dependência AllowFocusOnInteraction . |
| CharacterSpacing |
Obtém ou define o espaçamento uniforme entre caracteres, em unidades de 1/1000 de um em. |
| CharacterSpacingProperty |
Identifica a propriedade de dependência CharacterSpacing . |
| ContentEnd |
Obtém um TextPointer que representa o final do conteúdo no elemento . |
| ContentStart |
Obtém um TextPointer que representa o início do conteúdo no elemento . |
| 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. |
| ElementStart |
Obtém um TextPointer que representa a posição pouco antes do início do elemento. |
| ExitDisplayModeOnAccessKeyInvoked |
Obtém ou define um valor que especifica se a exibição da chave de acesso é ignorada quando uma chave de acesso é invocada. |
| ExitDisplayModeOnAccessKeyInvokedProperty |
Identifica a propriedade de dependência ExitDisplayModeOnAccessKeyInvoked . |
| FontFamily |
Obtém ou define a família de fontes preferencial de nível superior para o conteúdo do elemento. |
| FontFamilyProperty |
Identifica a propriedade de dependência FontFamily . |
| FontSize |
Obtém ou define o tamanho da fonte para o conteúdo do elemento. |
| FontSizeProperty |
Identifica a propriedade de dependência FontSize . |
| FontStretch |
Obtém ou define a largura do glifo da fonte em uma família a ser selecionada. |
| FontStretchProperty |
Identifica a propriedade de dependência FontStretch . |
| FontStyle |
Obtém ou define o estilo da fonte para o conteúdo neste elemento. |
| FontStyleProperty |
Identifica a propriedade de dependência FontStyle . |
| 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. |
| FontWeightProperty |
Identifica a propriedade de dependência FontWeight . |
| Foreground |
Obtém ou define o Pincel a ser aplicado ao conteúdo neste elemento. |
| ForegroundProperty |
Identifica a propriedade de dependência Foreground . |
| IsAccessKeyScope |
Obtém ou define um valor que indica se um elemento define seu próprio escopo de chave de acesso. |
| IsAccessKeyScopeProperty |
Identifica a propriedade de dependência IsAccessKeyScope . |
| 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. |
| IsTextScaleFactorEnabledProperty |
Identifica a propriedade de dependência IsTextScaleFactorEnabled . |
| 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. |
| KeyTipHorizontalOffsetProperty |
Identifica a propriedade de dependência KeyTipHorizontalOffset . |
| KeyTipPlacementMode |
Obtém ou define um valor que indica onde a Dica de Chave é colocada em relação ao elemento de texto. |
| KeyTipPlacementModeProperty |
Identifica a propriedade de dependência KeyTipPlacementMode . |
| KeyTipVerticalOffset |
Obtém ou define um valor que indica até que ponto a dica de chave é colocada em relação ao elemento de texto. |
| KeyTipVerticalOffsetProperty |
Identifica a propriedade de dependência KeyTipVerticalOffset . |
| Language |
Obtém ou define informações de idioma de localização/globalização que se aplicam a um TextElement. |
| LanguageProperty |
Identifica a propriedade Dependência de linguagem . |
| 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. |
| TextDecorations |
Obtém ou define um valor que indica quais decorações são aplicadas ao texto. |
| TextDecorationsProperty |
Identifica a propriedade de dependência TextDecorations . |
| XamlRoot |
Obtém ou define o XamlRoot no qual esse elemento está sendo exibido. |
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. |
| 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. |
| 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. |
| 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. |
| 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. |