InlineUIContainer 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.
Fornece um elemento de conteúdo embutido que permite que os tipos UIElement sejam inseridos no conteúdo de um RichTextBlock.
public ref class InlineUIContainer sealed : Inline/// [Microsoft.UI.Xaml.Markup.ContentProperty(Name="Child")]
/// [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 InlineUIContainer final : Inline[Microsoft.UI.Xaml.Markup.ContentProperty(Name="Child")]
[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 InlineUIContainer : InlinePublic NotInheritable Class InlineUIContainer
Inherits Inline<InlineUIContainer .../>
-or-
<InlineUIContainer ...>
singleChild
</InlineUIContainer>
- Herança
- Atributos
Exemplos
O exemplo de código a seguir mostra como você pode inserir uma imagem em um RichTextBlock usando InlineUIContainer.
<RichTextBlock>
<Paragraph>
<Italic>This is an inline image.</Italic>
<InlineUIContainer>
<Image Source="Assets/SmallLogo.png" Height="30" Width="30"/>
</InlineUIContainer>
Mauris auctor tincidunt auctor.
</Paragraph>
</RichTextBlock>
Comentários
O cenário mais comum para usar um objeto InlineUIContainer é introduzir uma imagem no conteúdo do texto. Use um novo objeto Image para a imagem, como o conteúdo filho de um InlineUIContainer. Defina Altura e Largura na imagem se você não quiser que ela seja dimensionada para o tamanho da imagem natural.
Se você quiser mais de um elemento embutido na mesma posição, considere usar um painel como o único filho InlineUIContainer e, em seguida, colocar os vários elementos dentro desse painel.
Se colocado em um InlineUIContainer, um controle que pode ser focado ainda aparecerá na sequência de guias de nível superior.
Se você quiser um texto interativo, considere usar um elemento Hyperlink (um tipo de Inline) em vez de usar InlineUIContainer com um Button ou semelhante dentro dele. Consulte Diretrizes para links.
InlineUIContainer herda propriedades da classe TextElement . No entanto, a maioria dessas propriedades não tem nenhum efeito visível. É mais comum declarar um elemento de objeto InlineUIContainer em XAML sem que haja nenhum conjunto de atributos (exceto possivelmente atributo x:Name) com o único elemento filho que você está inlining como conteúdo do elemento de objeto InlineUIContainer.
Definir propriedades em InlineUIContainer que, de outra forma, afetam a altura da linha de caractere de um elemento de texto (como FontSize, FontFamily) não tem efeito na renderização e aparência. O conteúdo determina seu tamanho e os tamanhos InlineUIContainer para ajustá-lo.
Se houver mais texto dentro do conteúdo filho (como TextBlock.Text ou outros elementos de texto em um RichTextBlock aninhado), as propriedades do elemento de texto do pai InlineUIContainer não herdarão no conteúdo, elas serão ignoradas.
Construtores
| InlineUIContainer() |
Inicializa uma nova instância da classe InlineUIContainer . |
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) |
| Child |
Obtém ou define o UIElement hospedado pelo InlineUIContainer. |
| 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) |
| 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) |
| 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) |