InlineUIContainer Класс
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Предоставляет встроенный элемент содержимого, который позволяет внедрять типы 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>
- Наследование
- Атрибуты
Примеры
В следующем примере кода показано, как вставить изображение в 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 |
Всегда возвращает в |
DispatcherQueue |
Возвращает объект , |
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) |