Partilhar via


Span Classe

Definição

Agrupa outros elementos de conteúdo embutido . Classe pai para Negrito, Hiperlink, Itálico e Sublinhado.

/// [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="Inlines")]
class Span : 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="Inlines")]
public class Span : Inline
Public Class Span
Inherits Inline
<Span .../>
-or-
<Span ...>
  oneOrMoreInlines
</Span>
-or-
<Span ...>
  mixedContent
</Span>
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

Você pode usar Span como um elemento de objeto em XAML para incluir texto. Isso permite um uso semelhante ao modo como você pode usar a span marca em HTML. Para esse uso, você definiria os atributos compatíveis com TextElement , como FontSize ou FontFamily, para que você possa aplicar essas decisões de formatação de texto ao intervalo delimitado do texto. A execução tem uma funcionalidade semelhante de aplicar propriedades TextElement a um intervalo de texto, mas Executar não dá suporte a conteúdo misto (sua propriedade de conteúdo XAML Run.Text só pode conter texto, conteúdo não misto e mais embutidos).

O Span dá suporte a conteúdo misto se você definir o conteúdo em XAML. Isso significa que você pode misturar marcas embutidas como Executar, Negrito e assim por diante com conteúdo de texto XAML (texto sem formatação), sem restrições na ordem em que as marcas versus o texto devem aparecer. Todo o texto, seja texto sem formatação ou delimitado em uma marca embutida , é renderizado na ordem em que o texto é definido no conteúdo misto. Por exemplo, isso é XAML legal:

<RichTextBlock>
  <Paragraph>
    <Span>This is <Bold>mixed content</Bold> with multiple text areas <Italic> and inlines</Italic>.</Span>
  </Paragraph>
</RichTextBlock>

Quando o conteúdo misto é analisado do XAML e o modelo de objeto de texto é examinado em tempo de execução, qualquer área de texto proveniente do texto sem formatação gera um objeto Run na posição de ordem de leitura apropriada na classe de coleção InlineCollection que permite o acesso em tempo de execução. Esse elemento Run contém o texto, mas, caso contrário, não tem nenhuma propriedade definida.

Observação

Há suporte para a colocação de conteúdo XAML, seja marcas ou texto diretamente dentro de um elemento Span, pois Span indica que sua propriedade Inlines é a propriedade de conteúdo XAML. Para obter mais informações sobre propriedades de conteúdo XAML, consulte a seção "Propriedades de conteúdo XAML" do guia de sintaxe XAML.

Elementos span normalmente são usados como elementos em uma InlineCollection, seja como elementos filho de um Paragraph (torna-se parte de Paragraph.Inlines) ou como o conteúdo de outro Span (torna-se parte de Span.Inlines).

Classes derivadas de span

Span é a classe pai de várias classes derivadas que definem uma região de texto embutida com uma convenção de formatação específica:

  • Negrito
  • Hiperlink
  • Itálico
  • SublinharHiperlink habilita um comportamento de clique que navega até o NavigateUri. As outras classes derivadas de Span podem ser consideradas decorações específicas da classe para o texto e, de outra forma, não adicionam interação.

Construtores

Span()

Inicializa uma nova instância da classe Span .

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 o 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)
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)
Inlines

Obtém uma InlineCollection que contém os elementos embutidos de nível superior que incluem o conteúdo de Span.

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

Aplica-se a

Confira também