InlineUIContainer Класс

Определение

Пространство имен:

Microsoft.UI.Xaml.Documents

Предоставляет встроенный элемент содержимого, который позволяет внедрять типы UIElement в содержимое 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 : Inline

Public NotInheritable Class InlineUIContainer
Inherits Inline

<InlineUIContainer .../>
-or-
<InlineUIContainer ...>
  singleChild
</InlineUIContainer>

Наследование

Object Platform::Object IInspectable DependencyObject TextElement Inline InlineUIContainer

Атрибуты

ContentPropertyAttribute ActivatableAttribute ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Примеры

В следующем примере кода показано, как вставить изображение в RichTextBlock с помощью 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>

Комментарии

Наиболее распространенным сценарием использования объекта InlineUIContainer является введение изображения в текстовое содержимое. Используйте новый объект Image для изображения в качестве дочернего содержимого для InlineUIContainer. Задайте для изображения высоту и ширину , если вы не хотите, чтобы оно масштабироваться до естественного размера изображения.

Если вы хотите, чтобы несколько элементов были вложены в одну и ту же позицию, рассмотрите возможность использования панели в качестве одного дочернего элемента InlineUIContainer и последующего размещения нескольких элементов в этой панели.

При размещении внутри InlineUIContainer элемент управления, который можно сфокусировать, по-прежнему отображается в последовательности вкладок верхнего уровня.

Если вам нужен интерактивный текст, рекомендуется использовать элемент Hyperlink (тип Inline), а не InlineUIContainer с элементом Button или аналогичным внутри него. Ссылки см . в разделе Рекомендации.

InlineUIContainer наследует свойства от класса TextElement . Однако большинство этих свойств не имеют видимого эффекта. Чаще всего объектный элемент InlineUIContainer объявляется в XAML без установки атрибутов (за исключением атрибута x:Name) с одним дочерним элементом, который вы встраивали как содержимое элемента объекта InlineUIContainer.

Установка свойств InlineUIContainer, которые в противном случае влияют на высоту строки символов текстового элемента (например , FontSize, FontFamily), не влияет на отрисовку и внешний вид. Содержимое определяет его размер и размеры InlineUIContainer в соответствии с ним.

Если в дочернем содержимом есть дополнительный текст (например , TextBlock.Text или другие текстовые элементы во вложенном элементе RichTextBlock), свойства текстового элемента родительского элемента InlineUIContainer не наследуются в содержимом, они игнорируются.

Конструкторы

InlineUIContainer()

Инициализирует новый экземпляр класса InlineUIContainer .

Свойства

AccessKey	Возвращает или задает ключ доступа для этого элемента. (Унаследовано от TextElement)
AccessKeyScopeOwner	Возвращает или задает исходный элемент, предоставляющий ключ доступа область для этого элемента, даже если он не находится в визуальном дереве исходного элемента. (Унаследовано от TextElement)
AllowFocusOnInteraction	Возвращает или задает значение, указывающее, получает ли элемент фокус автоматически, когда пользователь взаимодействует с ним. (Унаследовано от TextElement)
CharacterSpacing	Возвращает или задает равномерный интервал между символами в единицах 1/1000 em. (Унаследовано от TextElement)
Child	Возвращает или задает элемент UIElement , размещенный в InlineUIContainer.
ContentEnd	Возвращает объект TextPointer , представляющий конец содержимого в элементе . (Унаследовано от TextElement)
ContentStart	Возвращает объект TextPointer , представляющий начало содержимого в элементе . (Унаследовано от TextElement)
Dispatcher	Всегда возвращает в null приложении Windows App SDK. Вместо этого используйте DispatcherQueue . (Унаследовано от DependencyObject)
DispatcherQueue	Возвращает объект , DispatcherQueue с которым связан этот объект. представляет DispatcherQueue средство, которое может получить доступ к в потоке DependencyObject пользовательского интерфейса, даже если код инициируется потоком, не относящегося к пользовательскому интерфейсу. (Унаследовано от DependencyObject)
ElementEnd	Возвращает объект TextPointer , представляющий позицию сразу после конца элемента. (Унаследовано от TextElement)
ElementStart	Возвращает объект TextPointer , представляющий позицию непосредственно перед началом элемента. (Унаследовано от TextElement)
ExitDisplayModeOnAccessKeyInvoked	Возвращает или задает значение, указывающее, закрывается ли отображение ключа доступа при вызове ключа доступа. (Унаследовано от TextElement)
FontFamily	Возвращает или задает предпочтительное семейство шрифтов верхнего уровня для содержимого элемента. (Унаследовано от TextElement)
FontSize	Получает или задает размер шрифта для содержимого элемента. (Унаследовано от TextElement)
FontStretch	Возвращает или задает ширину глифа шрифта в семействе для выбора. (Унаследовано от TextElement)
FontStyle	Возвращает или задает стиль шрифта для содержимого в этом элементе. (Унаследовано от TextElement)
FontWeight	Возвращает или задает вес шрифта верхнего уровня, выбираемый из семейства шрифтов для содержимого в этом элементе. (Унаследовано от TextElement)
Foreground	Возвращает или задает кисть для применения к содержимому в этом элементе. (Унаследовано от TextElement)
IsAccessKeyScope	Возвращает или задает значение, указывающее, определяет ли элемент собственный ключ доступа область. (Унаследовано от TextElement)
IsTextScaleFactorEnabled	Возвращает или задает значение, указывающее, включено ли автоматическое увеличение текста в соответствии с параметром системного размера текста. (Унаследовано от TextElement)
KeyTipHorizontalOffset	Возвращает или задает значение, указывающее, насколько далеко слева или справа расположена подсказка клавиши относительно текстового элемента. (Унаследовано от TextElement)
KeyTipPlacementMode	Возвращает или задает значение, указывающее, где находится подсказка клавиши относительно текстового элемента. (Унаследовано от TextElement)
KeyTipVerticalOffset	Возвращает или задает значение, указывающее, насколько далеко расположена подсказка клавиши по отношению к текстовому элементу. (Унаследовано от TextElement)
Language	Возвращает или задает сведения о языке локализации и глобализации, которые применяются к Элементу TextElement. (Унаследовано от TextElement)
Name	Возвращает или задает уникальную идентификацию для объекта . Имя можно задать только при первоначальном синтаксическом анализе XAML. (Унаследовано от TextElement)
TextDecorations	Возвращает или задает значение, указывающее, какие украшения применяются к тексту. (Унаследовано от TextElement)
XamlRoot	Возвращает или задает xamlRoot, в котором просматривается данный элемент. (Унаследовано от TextElement)

Методы

ClearValue(DependencyProperty)	Очищает локальное значение свойства зависимостей. (Унаследовано от DependencyObject)
FindName(String)	Извлекает объект в объектной модели или графе объектов среды выполнения, ссылаясь на значение атрибута x:Name или Name объекта. (Унаследовано от TextElement)
GetAnimationBaseValue(DependencyProperty)	Возвращает любое базовое значение, установленное для свойства зависимостей, которое применяется в случаях, когда анимация не активна. (Унаследовано от DependencyObject)
GetValue(DependencyProperty)	Возвращает текущее действующее значение свойства зависимостей из DependencyObject. (Унаследовано от DependencyObject)
OnDisconnectVisualChildren()	Переопределите этот метод, чтобы реализовать поведение макета и логики при удалении элементов из содержимого или дочернего свойства класса. (Унаследовано от TextElement)
ReadLocalValue(DependencyProperty)	Возвращает локальное значение свойства зависимостей, если задано локальное значение. (Унаследовано от DependencyObject)
RegisterPropertyChangedCallback(DependencyProperty, DependencyPropertyChangedCallback)	Регистрирует функцию уведомления для прослушивания изменений определенного DependencyProperty в этом экземпляре DependencyObject . (Унаследовано от DependencyObject)
SetValue(DependencyProperty, Object)	Задает локальное значение свойства зависимостей для Объекта DependencyObject. (Унаследовано от DependencyObject)
UnregisterPropertyChangedCallback(DependencyProperty, Int64)	Отменяет уведомление об изменениях, которое было ранее зарегистрировано путем вызова Метода RegisterPropertyChangedCallback. (Унаследовано от DependencyObject)

События

AccessKeyDisplayDismissed	Происходит после завершения последовательности ключей доступа для уведомления элементов управления о том, что они должны скрывать визуальные элементы ключа доступа. (Унаследовано от TextElement)
AccessKeyDisplayRequested	Происходит при запуске последовательности ключей доступа для уведомления элементов управления о том, что они должны отображать визуальные элементы ключа доступа. (Унаследовано от TextElement)
AccessKeyInvoked	Происходит, когда пользователь завершает последовательность клавиш доступа, чтобы уведомить элемент о том, что необходимо вызвать действие ключа доступа. (Унаследовано от TextElement)

См. также раздел

• Inline
• RichTextBlock
• UIElement