Поделиться через


TextElement Класс

Определение

Абстрактный класс, используемый в качестве базового класса для также абстрактных классов Block и Inline . TextElement поддерживает общий API для классов, участвующих в текстовой объектной модели XAML, таких как свойства, управляющие размером текста, семействами шрифтов и т. д.

public ref class TextElement : DependencyObject
/// [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 TextElement : DependencyObject
[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 class TextElement : DependencyObject
Public Class TextElement
Inherits DependencyObject
Наследование
Object Platform::Object IInspectable DependencyObject TextElement
Производный
Атрибуты

Комментарии

Различные свойства, определенные TextElement, поддерживают общий API для классов, участвующих в текстовой объектной модели XAML. Ниже приведен список наиболее часто используемых свойств.

Задав свойства TextElement, вы можете применить к тексту общие свойства форматирования текста как в блоках, так и в строках. Существуют также дополнительные способы форматирования текста, но они не поддерживаются непосредственно TextElement. Вместо этого можно использовать присоединенные свойства класса Typography . Присоединенные свойства типографии обычно поддерживают расширенные типографические функции или соглашения, такие как доступ к типографическим функциям, определенным на уровне шрифта, которые не обязательно поддерживаются всеми шрифтами. Например, вы можете задать Typography.Variants в качестве присоединенного свойства для любого блока текста или встроенного текста, и это повлияет на поведение вариантов шрифтов, включаемое определенным шрифтом, выбранным для настройки FontFamily для этого текстового элемента.

TextElement не определяет точку подключения к визуальному дереву XAML. Другими словами, TextElement определяет текст и текстовую объектную модель в этом тексте, но пока не позволяет отображать этот текст в пользовательском интерфейсе. Для этого необходимо использовать один из элементов управления или элементов, которые являются потомками UIElement и могут быть подключены к дереву XAML и корневому визуальному элементу окна приложения. В среда выполнения Windows есть два таких элемента:

  • TextBlock: поддерживает текстовую объектную модель строк только с коллекцией Inlines .
  • RichTextBlock: поддерживает объектную модель блочного текста с ее коллекцией Blocks . Блоки могут содержать блоки и встроенные элементы.

Примечание

PasswordBox, RichEditBox и TextBox не поддерживают текстовую объектную модель, основанную на TextElement. RichEditBox обеспечивает программный доступ к другой текстовой объектной модели через интерфейс ITextDocument .

TextElement определяет API, который поддерживает проверку текстовой объектной модели как программных объектов после анализа XAML. В частности, TextElement реализует Name и Language, которые параллельно свойства с тем же именем в FrameworkElement. TextElement также реализует FindName (служебный метод для поиска объектов во время выполнения на основе того, как имя было задано в начальном коде XAML) и OnDisconnectVisualChildren (для расширенных сценариев и поддержки конструктора).

TextElement имеет четыре свойства, которые предоставляют доступ к объектам TextPointer из текста. Эти свойства: ContentStart, ContentEnd, ElementStart, ElementEnd. Объект TextPointer среда выполнения Windows предоставляет точку входа для обхода содержимого. Дополнительные сведения см. в разделе TextPointer.

TextElement — это класс, производный от DependencyObject. Это означает, что он может определять свойства зависимостей, и каждое из свойств чтения и записи TextElement является свойством зависимостей, идентификатор свойства также определяется TextElement. Дополнительные сведения о том, какие свойства зависимостей позволяют, см. в статье Общие сведения о свойствах зависимостей.

Производные классы TextElement

TextElement является родительским классом для двух производных классов, разделяющих текстовую объектную модель на два соглашения об использовании текста: Block и Inline. Block и Inline считаются базовыми классами (тег в XAML обычно не отображается <Block> ) и существуют в иерархии главным образом для того, чтобы быть родительским классом других практических текстовых элементов. Например, Block является родительским классом Paragraph. Дополнительные сведения об использовании блоков и встроенных элементов см. в разделе Блок текста.

Свойства

AccessKey

Возвращает или задает ключ доступа для этого элемента.

AccessKeyProperty

Определяет свойство зависимостей AccessKey .

AccessKeyScopeOwner

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

AccessKeyScopeOwnerProperty

Определяет свойство зависимостей AccessKeyScopeOwner .

AllowFocusOnInteraction

Возвращает или задает значение, указывающее, получает ли элемент фокус автоматически, когда пользователь взаимодействует с ним.

AllowFocusOnInteractionProperty

Определяет свойство зависимости AllowFocusOnInteraction .

CharacterSpacing

Возвращает или задает равномерный интервал между символами в единицах 1/1000 em.

CharacterSpacingProperty

Определяет свойство зависимости CharacterSpacing .

ContentEnd

Возвращает объект TextPointer , представляющий конец содержимого в элементе .

ContentStart

Возвращает объект TextPointer , представляющий начало содержимого в элементе .

Dispatcher

Всегда возвращает в null приложении Windows App SDK. Вместо этого используйте DispatcherQueue .

(Унаследовано от DependencyObject)
DispatcherQueue

Возвращает объект , DispatcherQueue с которым связан этот объект. представляет DispatcherQueue средство, которое может получить доступ к в потоке DependencyObject пользовательского интерфейса, даже если код инициируется потоком, не относящегося к пользовательскому интерфейсу.

(Унаследовано от DependencyObject)
ElementEnd

Возвращает объект TextPointer , представляющий позицию сразу после конца элемента.

ElementStart

Возвращает объект TextPointer , представляющий позицию непосредственно перед началом элемента.

ExitDisplayModeOnAccessKeyInvoked

Возвращает или задает значение, указывающее, закрывается ли отображение ключа доступа при вызове ключа доступа.

ExitDisplayModeOnAccessKeyInvokedProperty

Определяет свойство зависимости ExitDisplayModeOnAccessKeyInvoked .

FontFamily

Возвращает или задает предпочтительное семейство шрифтов верхнего уровня для содержимого элемента.

FontFamilyProperty

Определяет свойство зависимости FontFamily .

FontSize

Получает или задает размер шрифта для содержимого элемента.

FontSizeProperty

Определяет свойство зависимости FontSize .

FontStretch

Возвращает или задает ширину глифа шрифта в семействе для выбора.

FontStretchProperty

Определяет свойство зависимости FontStretch .

FontStyle

Возвращает или задает стиль шрифта для содержимого в этом элементе.

FontStyleProperty

Определяет свойство зависимости FontStyle .

FontWeight

Возвращает или задает вес шрифта верхнего уровня, выбираемый из семейства шрифтов для содержимого в этом элементе.

FontWeightProperty

Определяет свойство зависимости FontWeight .

Foreground

Возвращает или задает кисть для применения к содержимому в этом элементе.

ForegroundProperty

Идентифицирует свойство зависимости переднего плана .

IsAccessKeyScope

Возвращает или задает значение, указывающее, определяет ли элемент собственный ключ доступа область.

IsAccessKeyScopeProperty

Определяет свойство зависимости IsAccessKeyScope .

IsTextScaleFactorEnabled

Возвращает или задает значение, указывающее, включено ли автоматическое увеличение текста в соответствии с параметром системного размера текста.

IsTextScaleFactorEnabledProperty

Определяет свойство зависимости IsTextScaleFactorEnabled .

KeyTipHorizontalOffset

Возвращает или задает значение, указывающее, насколько далеко слева или справа расположена подсказка клавиши относительно текстового элемента.

KeyTipHorizontalOffsetProperty

Определяет свойство зависимости KeyTipHorizontalOffset .

KeyTipPlacementMode

Возвращает или задает значение, указывающее, где находится подсказка клавиши относительно текстового элемента.

KeyTipPlacementModeProperty

Определяет свойство зависимости KeyTipPlacementMode .

KeyTipVerticalOffset

Возвращает или задает значение, указывающее, насколько далеко расположена подсказка клавиши по отношению к текстовому элементу.

KeyTipVerticalOffsetProperty

Определяет свойство зависимости KeyTipVerticalOffset .

Language

Возвращает или задает сведения о языке локализации и глобализации, которые применяются к Элементу TextElement.

LanguageProperty

Определяет свойство Языковой зависимости.

Name

Возвращает или задает уникальную идентификацию для объекта . Имя можно задать только при первоначальном синтаксическом анализе XAML.

TextDecorations

Возвращает или задает значение, указывающее, какие украшения применяются к тексту.

TextDecorationsProperty

Определяет свойство зависимостей TextDecorations .

XamlRoot

Возвращает или задает xamlRoot, в котором просматривается данный элемент.

Методы

ClearValue(DependencyProperty)

Очищает локальное значение свойства зависимостей.

(Унаследовано от DependencyObject)
FindName(String)

Извлекает объект в объектной модели или графе объектов среды выполнения, ссылаясь на значение атрибута x:Name или Name объекта.

GetAnimationBaseValue(DependencyProperty)

Возвращает любое базовое значение, установленное для свойства зависимостей, которое применяется в случаях, когда анимация не активна.

(Унаследовано от DependencyObject)
GetValue(DependencyProperty)

Возвращает текущее действующее значение свойства зависимостей из DependencyObject.

(Унаследовано от DependencyObject)
OnDisconnectVisualChildren()

Переопределите этот метод, чтобы реализовать поведение макета и логики при удалении элементов из содержимого или дочернего свойства класса.

ReadLocalValue(DependencyProperty)

Возвращает локальное значение свойства зависимостей, если задано локальное значение.

(Унаследовано от DependencyObject)
RegisterPropertyChangedCallback(DependencyProperty, DependencyPropertyChangedCallback)

Регистрирует функцию уведомления для прослушивания изменений определенного DependencyProperty в этом экземпляре DependencyObject .

(Унаследовано от DependencyObject)
SetValue(DependencyProperty, Object)

Задает локальное значение свойства зависимостей для Объекта DependencyObject.

(Унаследовано от DependencyObject)
UnregisterPropertyChangedCallback(DependencyProperty, Int64)

Отменяет уведомление об изменениях, которое было ранее зарегистрировано путем вызова Метода RegisterPropertyChangedCallback.

(Унаследовано от DependencyObject)

События

AccessKeyDisplayDismissed

Происходит после завершения последовательности ключей доступа для уведомления элементов управления о том, что они должны скрывать визуальные элементы ключа доступа.

AccessKeyDisplayRequested

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

AccessKeyInvoked

Происходит, когда пользователь завершает последовательность клавиш доступа, чтобы уведомить элемент о том, что необходимо вызвать действие ключа доступа.

Применяется к

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